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.
Page Contents
Basic syntax
| You type | You get |
|---|---|
# Heading 1 | Largest heading |
## Heading 2 | Section heading |
### Heading 3 | Sub-section heading |
*italic* or _italic_ | Italic text |
**bold** | Bold text |
~~strikethrough~~ | Crossed-out text (GFM) |
[link text](https://example.com) | A link |
 | An image |
> quote | A 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 doand- [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.
Need a website or app for your business? Talk to Techpass Master – we design and build websites and apps for clients worldwide.
