Authoring Source Documents » Markdown++ Source Documents » Learning Markdown » Headings
Headings
Originally named the ATX heading, a Heading communicates a central idea for a topic. Headings should contain the main idea for a section, and have useful keywords to make the section easy to find in a search.
Syntax
Headings are created by starting a line of content with the # character. The # characters and the text content of the Heading need to be separated by a space character. The amount of # characters used indicates the level of heading which will be created.
Basics
Create a Heading 1 with a single #, a space, and some text.
# Heading 1
More # characters can be added to the Heading to increase the heading level, up to 6.
# Heading 1

## Heading 2

### Heading 3

#### Heading 4

##### Heading 5

###### Heading 6
Markdown++
A custom Paragraph Style can be given to a Heading using a Markdown++ style tag on the line directly above the Heading.
<!--style:CustomHeading-->
# Heading 1
To learn more about Markdown++ tagging, see Learning Markdown++.
Heading Behavior
Heading Alias
Each created Heading gets an alias that can be used to link to it from another place in the publication.
To determine the alias value, ePublisher takes the text of the Heading, lower-cases it, removes all non-alphanumeric characters, and replaces space with - characters.
The below Heading will get the alias value lets-go-to-the-moon.
# Let's Go to the Moon!
Any time the text of a Heading is changed, the alias will also change. It's recommended to use a Custom Alias to avoid having to change link paths when Headings change.
ePublisher Style Information
Style Behavior
The style name ePublisher will create for a Heading will is dependent on the number of # characters used at the front of the line. One # character creates the style name Heading 1, two # characters creates Heading 2, etc.
Default Style Properties
Style Type: Paragraph
Style Name: Heading 1, Heading 2, Heading 3, Heading 4, Heading 5, Heading 6
Heading 1
Property
Value
font family
Arial
font size
21pt
font weight
bold
line height
1.2em
padding top
0pt
padding bottom
12pt
Heading 2
Property
Value
font family
Arial
font size
18pt
font weight
bold
line height
1.2em
padding top
0pt
padding bottom
12pt
Heading 3
Property
Value
font family
Arial
font size
15pt
font weight
bold
line height
1.2em
padding top
0pt
padding bottom
12pt
Heading 4, Heading 5, Heading 6
Property
Value
font family
Arial
font size
12pt
font weight
bold
line height
1.2em
padding top
0pt
padding bottom
12pt
Default Style Options
Heading 1
Option
Value
Table of Contents level
2
Heading 2
Option
Value
Table of Contents level
3
Heading 3
Option
Value
Table of Contents level
4
Heading 4
Option
Value
Table of Contents level
5
Heading 5
Option
Value
Table of Contents level
6
Heading 6
Option
Value
Table of Contents level
none
If a custom style name is assigned to a Heading, that style name will still inherit all of the listed default style information for the matching Heading syntax.
Was this helpful?
Last modified date: 11/12/2021