# Markdown syntax

The Markdown syntax for headings, bold, lists, links, images, quotes and code, with each mark shown next to what it does and how to type a mark as text.

**Definition:** 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 | `![alt text](image.png)` |
| 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:

````markdown
```
# 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](/glossary/markdown-table).
- **Task lists:** `- [ ] to do` and `- [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](/glossary/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](/docs/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.

## Sources

1. [Daring Fireball: Markdown syntax](https://daringfireball.net/projects/markdown/syntax), checked 2026-11-10
2. [CommonMark](https://commonmark.org/), checked 2026-11-10
3. [GitHub Flavored Markdown Spec](https://github.github.com/gfm/), checked 2026-11-10
4. [Flywrite docs: The editor](/docs/the-editor), checked 2026-11-17

---

This is the Markdown copy of https://flywrite.app/glossary/markdown-syntax.
