Quick start – Creating your first Markdown document

The syntax of Markdown is incredibly simple and intuitive. At the end of this section, we will have learned all the syntax we need to write anything with Markdown.

Markdown documents are created as plain text files, and it's not a requirement to create these files with concrete file extensions to use them. However, in order for editors or applications to make sure that the file they are using is Markdown-formatted, we could use some of the most common file extensions, such as .md, .mkdn, or .markdown.

Step 1 – Inserting paragraph and line breaks

A paragraph of text is one or more consecutive lines:

A paragraph,
divided into two lines.

The preceding code will produce:

<p>A paragraph, divided into two ...

Get Instant Markdown now with O’Reilly online learning.

O’Reilly members experience live online training, plus books, videos, and digital content from 200+ publishers.