8

A recurring problem with new question-askers is poorly formatted code. When I look at the Help Center I do not find any guide to formatting code. Shouldn't there be something really obvious to help with that?

8
  • 3
    It's this isn't it? How do I format my code blocks? from the FAQ
    – khelwood
    Commented Aug 24, 2020 at 13:57
  • 3
    There is How do I format my posts using Markdown or HTML? in the Help Center. And when you hit the "More" button in the editor you'll be forwarded to Markdown help.
    – Ivar
    Commented Aug 24, 2020 at 13:57
  • 1
    It's linked to on the mcve page which should be getting read in it's entirety anyway Commented Aug 24, 2020 at 13:57
  • 3
    Reasoning where I would look for something like that, my personal intuition would be the "how do I ask a good question" page. Nada.
    – Gimby
    Commented Aug 24, 2020 at 13:58
  • Formatting isn't just important for asking though, @Gimby .
    – Thom A
    Commented Aug 24, 2020 at 13:59
  • 2
    The reference from @khelwood is great. But not on SO help. Ivar 's reference is what I was looking for. That fact that I did not see it seems to say that it is poorly placed.
    – G5W
    Commented Aug 24, 2020 at 14:03
  • @Larnu true enough, But at least something. Anything. A hint that the code formatting button exists and should be used, at the least.
    – Gimby
    Commented Aug 24, 2020 at 14:06
  • 5
    It’s all here: How do I format my code blocks?. Commented Aug 25, 2020 at 0:01

2 Answers 2

9

This is in the model section of the Help Centre, labeled How do I format my posts using Markdown or HTML?.

It is, however, one of the topics displayed on the help centre's home page: enter image description here

Though you might expect to find it in the Asking section, good formatting is important for answers too, and other parts of the site, such as tag info pages. Therefore it's better putting it in a less specific area, and the Model section works well for that.

3
  • 3
    Yes, This does it. Although I must say it is not an intuitive place for that link. Thanks for poining this out.
    – G5W
    Commented Aug 24, 2020 at 13:59
  • The help center's home page also includes a big search field across the top, and typing "formatting" into that brings up that article as the second hit... Commented Aug 24, 2020 at 14:03
  • @HereticMonkey Yes. I was using that incorrectly. I just scrolled all the way to the top and searched SO instead of searching help only. Searching SO gives unhelpful results, but I see that if I had used it correctly to search only help, it does give a good answer. Thank you.
    – G5W
    Commented Aug 24, 2020 at 14:06
5

The page How do I format my code blocks? is on this FAQ but maybe not easy enough to find if you're starting from the help centre.

Not the answer you're looking for? Browse other questions tagged .