Write in Markdown
Write topics in Markdown, with formatting you can type or pick from a small toolbar.
A Markdown topic stores its content as Markdown text. The editor shows the formatting as you type, so headings and lists look like headings and lists while you write. Readers see a normal formatted page.
When to use Markdown
- Your team already writes in Markdown and wants to paste existing
.mdcontent. - You want plain, consistent formatting without fonts, colors or layout choices.
Markdown topics don't support images, callouts, components or embedded media. For those, use a Rich Text topic. See Choose a topic type.
Turn on Markdown topics
An Owner or Admin installs the Markdown addon from Addons in the left menu. It's in beta. See Addons.
Create a Markdown topic
- In a document, select the arrow next to New above the topic tree, then Markdown.
- For a topic outside any document, open the create menu on Home and select Markdown. In New Markdown topic, enter the Title and select Create topic.

Format text
Use the toolbar, or type Markdown and the editor converts it as you go.
| Toolbar button | Or type |
|---|---|
| Heading 1, Heading 2, Heading 3 | #, ##, ### and a space at the start of a line |
| Bold | **text** |
| Italic | *text* |
| Strikethrough | ~~text~~ |
| Inline code | `text` |
| Bullet list | - or * and a space |
| Numbered list | 1. and a space |
| Task list | [ ] and a space |
| Blockquote | > and a space |
| Code block | ``` and a space or Enter |
| Link | Select text, select Link, and enter the address |
| Insert table | Adds a 3 × 3 table with a header row |
A line with --- becomes a horizontal line. Common shortcuts such as Ctrl+B and Ctrl+I (Cmd on Mac) work too.
Paste existing Markdown
Copy Markdown text from a .md file, a code editor or a wiki, and paste it into the topic. Headings, lists, tables, links and code come in formatted. Raw HTML inside the Markdown is not kept.
Save and publish
A Markdown topic saves automatically and publishes like any other topic. Its history works the same way too. See Drafts and version history.
If something goes wrong
Markdown is missing from the New menu
The Markdown addon isn't installed. Ask an Owner or Admin to install it.
Pasted HTML disappeared
Markdown topics keep Markdown only. Move content that needs HTML, images or embeds to a Rich Text topic.