Markdown syntax guide with examples
Published by InstantToolDeck · Updated November 2026
Markdown is a plain-text format that converts to HTML. It is used in README files, documentation, blogs and chat tools. Try each example in the Markdown editor to see it render.
Headings and paragraphs
# Heading 1 ## Heading 2 ### Heading 3 A paragraph is text separated from the next by a blank line.
Emphasis
*italic* **bold** ***both*** ~~strikethrough~~ `inline code`
Lists
- Bullet - Another - Nested (indent two spaces) 1. First 2. Second - [x] Done task - [ ] Open task
Links and images
[Link text](https://example.com) 
Always write meaningful alt text for images: it helps screen-reader users and search engines.
Block quotes and rules
> A quoted line ---
Code blocks
Surround code with three backticks. Add a language name for syntax highlighting where the site supports it.
```js const total = items.length; ```
Tables
| Name | Qty | |------|----:| | Pens | 12 |
The colons in the separator row set alignment: :-- left, :-: centre, --: right.
Flavours of Markdown
The original specification is small. GitHub Flavored Markdown adds tables, task lists and strikethrough, which this editor supports. Other platforms add extras such as footnotes or math, so check your platform's documentation.
Tips
- Leave a blank line before and after lists, tables and code blocks.
- Escape special characters with a backslash:
\*. - Raw HTML is allowed on some platforms but ignored on others. The editor shows it as plain text for safety.
Frequently asked questions
How do I convert Markdown to HTML?
Paste the Markdown into the editor and copy the HTML source from the output box.
How do I make a table in Markdown?
Use pipes between columns and a row of dashes under the header, as in the example above.
What is the difference between Markdown and HTML?
Markdown is a simpler way to write the most common HTML elements. It converts to HTML.
Can I write Markdown in Word or Google Docs?
Not natively, but you can write in Markdown, copy the rendered preview and paste it into those programs.