Headings and emphasis

Start a line with # for a main heading, ## for a section heading, and ### for a smaller one. Wrap text in two asterisks for bold and one asterisk for italic. Use two tildes for strikethrough.

  • # Heading 1
  • ## Heading 2
  • **bold**, *italic*, ~~strikethrough~~

Lists and task lists

Start a line with a dash for a bullet list, or a number and a dot for a numbered list. Add [ ] or [x] after the dash to make a task list.

  • - Bullet item
  • 1. Numbered item
  • - [x] Finished task
  • - [ ] Open task

Links, quotes and code

A link is written as [label](https://example.com). Start a line with > to make a quote. Wrap short code in single backticks, and wrap a block of code in three backticks on their own lines.

Tables

Separate columns with a vertical bar and add a row of dashes under the header. Colons in the dash row set the alignment: a colon on the right aligns the column to the right, and colons on both sides center it.

Preview before you publish

Different platforms render Markdown a little differently, so it helps to preview your text first. The Markdown Previewer shows a live result as you type and treats pasted HTML as plain text, so it is safe to paste untrusted content.

Common questions

Frequently asked questions

Does Markdown support colors or fonts?

Not on its own. Markdown covers structure, and the website or app decides the look.

What file extension does Markdown use?

Usually .md, and sometimes .markdown.

Can I use HTML inside Markdown?

Many platforms allow it, but the ToolWorkIt previewer shows HTML as plain text for safety.

Keep reading

More guides