Page structure

Sections and headings

Add headings to divide a page into sections. To add a heading, insert multiple # symbols and a space before the title text. The heading level changes based on how many # symbols you type.

You can use a different markup style for the first and second level headings:

  • To create a first-level heading, place any number of equal signs (=) in the line that comes after the heading.
  • To create a second-level heading, place any number of hyphens (-) in the line that comes after the heading.
Markup Result
# The first level header
The first level header
======
## The second level header
The second level header
--------------
### The third level header
#### The fourth level header
##### The fifth level header
###### The sixth level header
Links to sections

Use an anchor to create a section link. Anchors are created automatically for each new heading. Anchors follow page addresses after the # symbol.

To get a section link:

  1. Click § to the right of the section heading.

    The § symbol pops up as you hover your mouse over the heading.

  2. Open your browser's address bar and copy the section URL.

To learn more, see Anchor.

Paragraphs

To start a new paragraph, insert an empty line after the previous one.

Markup Result
First line of a paragraph.
Second line of a paragraph.

New paragraph.

Horizontal line

  • If you want to separate parts of text with a horizontal line, insert an empty line between them and type three hyphens ( -), “asterisks” (*), or underscores (_) in a row.
  • If you're using hyphens, you should also add another empty line before your horizontal line. Otherwise the previous line will turn into a heading.
Markup Result
---
****
___

Collapsing text

You can collapse a portion of your text by doing the following:

  1. Insert <{ before the text and then insert }> after the text.
  2. Enter the text for the expand link after the <{ symbols.
Markup Result
<{Read the entire text
This text can be seen by 
clicking the link "Read the entire text".
}>