Markdown guide · Text

Headings

Start a line with # for a heading. More #s mean a smaller heading.

Put one to six # characters, then a space, at the start of a line. One # is the biggest heading (the document title); six is the smallest.

You type
# Document title
## Section
### Subsection
#### Smaller still
You get

Document title

Section

Subsection

Smaller still

  • Always put a space after the # characters. #Heading stays plain text.
  • Use one level-1 heading per document, then work down in order. Don't skip from ## to ####. Readers and screen readers follow that outline, and so do Word's navigation pane and PDF bookmarks.
  • Leave a blank line before and after a heading.

An older style underlines the heading text with === (level 1) or --- (level 2). It works, but the # style is easier to read and to change.

You type
Document title
==============

Section
-------
You get

Document title

Section

Tip In Styled Mode, the H button on the toolbar picks a heading level.
Write Markdown without memorizing it.

Prosedown shows your document styled as you type, with the Markdown one click away. This guide is built in: press F1.

Try it free for 14 days