Markdown syntax is the small set of punctuation marks, such as # for a heading, ** for bold and [text](url) for a link, that tells a Markdown app how to format plain text.
The marks
| To get | Type |
|---|---|
| A heading | # Heading (one to six #, for six levels) |
| Bold | **bold** |
| Italic | *italic* or _italic_ |
| A bulleted list | - item at the start of each line |
| A numbered list | 1. item at the start of each line |
| A link | [link text](https://example.com) |
| An image |  |
| A quote | > quoted line |
| Code in a sentence | `code` |
| A horizontal rule | --- on a line of its own |
A code block is a few lines between two lines of three backticks. Markdown shows everything inside it as typed, marks included:
```
# This stays a hash sign, not a heading.
```
Leave a blank line between paragraphs. Two lines with no blank line between them join into one paragraph.
The extras
GitHub Flavored Markdown adds a few marks the original syntax doesn't have:
- Tables: columns split by pipes, with a row of hyphens under the header. See Markdown table.
- Task lists:
- [ ] to doand- [x] done. - Strikethrough:
~~struck~~.
Details about the file itself, such as a title and date, go in a block at the top called YAML front matter.
In Flywrite
Rendered view styles the text like the finished piece, with the marks dimmed or out of the way, and ⌘E switches to Source view, where every mark is visible and editable. Select text and the formatting toolbar applies bold, italic, headings, links, images, code, lists, checklists and quotes, so you don't have to type the marks. The file keeps the plain Markdown either way. More in The editor.
Questions
Is Markdown syntax the same in every app?
The core marks are. Extras such as tables and task lists come from GitHub Flavored Markdown, so an app that follows only the original syntax shows them as plain text. CommonMark and GitHub Flavored Markdown are two published specifications that pin the syntax down.
How do I type a * or # without formatting?
Put a backslash before it, as in \*, and the mark shows as a character instead of formatting the text.
- Daring Fireball: Markdown syntax. Checked .
- CommonMark. Checked .
- GitHub Flavored Markdown Spec. Checked .
- Flywrite docs: The editor. Checked .