Markdown Cheat Sheet: Syntax Guide With Examples

Markdown lets you format text with simple symbols instead of buttons: # for headings, ** for bold, - for lists. It is used in README files, documentation, GitHub, Notion, Reddit, chat apps, static site generators and many note-taking apps. Learn it once and use it everywhere.

Free tool
Convert Markdown to HTML
Write or paste Markdown and get clean HTML with a live preview – headings, lists, task lists, tables, code blocks, links and images. Free.
Open Markdown to HTML →

Basic syntax

You typeYou get
# Heading 1Largest heading
## Heading 2Section heading
### Heading 3Sub-section heading
*italic* or _italic_Italic text
**bold**Bold text
~~strikethrough~~Crossed-out text (GFM)
[link text](https://example.com)A link
![alt text](image.png)An image
> quoteA block quote
---A horizontal line

Lists

  • Bullets: start a line with -, * or +.
  • Numbered: 1., 2., 3. – the numbers can even all be 1.
  • Nested: indent by two to four spaces.
  • Task lists (GFM): - [ ] To do and - [x] Done.

Code

  • Inline code: wrap in single backticks.
  • Code blocks: put three backticks on the line before and after, and add the language name after the opening backticks for syntax highlighting.

Tables (GitHub-flavoured Markdown)

Separate columns with pipes and add a line of dashes under the header. Colons in the dash line set alignment: :--- left, :---: centre, ---: right. Tables are part of GitHub-flavoured Markdown, not the original specification, so check that your platform supports them.

Line breaks and paragraphs

  • A blank line starts a new paragraph.
  • A single line break is often ignored. End a line with two spaces or a backslash to force a break.

Flavours of Markdown

  • Original Markdown – created by John Gruber in 2004.
  • CommonMark – a precise standard that removes ambiguities.
  • GitHub-flavoured Markdown (GFM) – adds tables, task lists, strikethrough and autolinks.
  • Many apps add their own extras (footnotes, callouts, math).

Markdown to HTML

Websites need HTML. Convert your Markdown with the Markdown to HTML converter, preview the result, then paste the HTML into your CMS, email template or app. If the Markdown comes from users, always sanitise the HTML before displaying it to prevent malicious scripts.

Writing tips

  • Use one H1 per document, then H2 and H3 in order.
  • Keep paragraphs short and add lists for steps.
  • Add alt text to images.
  • Check length with the Word Counter.

FAQ

What is Markdown used for?

README files, documentation, notes, blog posts, chat messages and anywhere simple formatting is needed.

How do I make text bold in Markdown?

Put two asterisks on each side of the text, with no spaces inside them.

Does Markdown support tables?

Yes, in GitHub-flavoured Markdown and most modern tools.

What is the difference between Markdown and HTML?

Markdown is a simple writing syntax that is usually converted into HTML for display.

Is my text uploaded?

No. The converter runs in your browser.

Free tool
Try the free Markdown to HTML
No signup and nothing uploaded – it runs right in your browser. Browse all 74 free tools on our Free Tools page.
Open Markdown to HTML →

Need a website or app for your business? Talk to Techpass Master – we design and build websites and apps for clients worldwide.

WhatsApp us📞 Call now