Headings

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/15/2024