Markdown guide for beginners: complete syntax with examples and free editor
Learn Markdown from scratch. Headings, lists, links, images, tables, code and more. Free online editor with live preview.
What is Markdown and why use it
Markdown is a lightweight markup language created by John Gruber and Aaron Swartz in 2004. Format plain text with simple syntax that converts to HTML.
Where Markdown is used in 2026:
- GitHub: README.md, issues, PRs, wikis.
- Documentation: Docusaurus, MkDocs, Gitbook, Notion.
- Blogs: Jekyll, Hugo, Next.js MDX.
- Notes: Obsidian, Logseq, Bear.
- Messaging: Slack, Discord, Reddit support Markdown subsets.
Practice with the NexTools Markdown editor with live preview.
Basic syntax: headings, paragraphs, emphasis
Headings: # H1, ## H2, ### H3, #### H4
Emphasis:
*italic*or_italic_**bold**or__bold__***bold italic***~~strikethrough~~(GFM)
Lists, links, and images
Unordered: - Item or * Item
Ordered: 1. First
Links: [Text](https://example.com)
Images: 
Generate URL-friendly slugs with the NexTools slug generator.
Code, code blocks, and tables
Inline code: `variable`
Code block: Triple backticks with language: ```javascript
Tables (GFM):
| Col 1 | Col 2 |
|-------|-------|
| Cell | Cell |
Validate JSON in code blocks with the NexTools JSON validator.
Advanced elements: quotes, rules, checklists
Blockquotes: > Quote text
Horizontal rule: ---
Checklist (GFM): - [x] Done, - [ ] Todo
Footnotes (Extended): Text[^1]. [^1]: Footnote.
HTML in Markdown: Most renderers allow direct HTML.
Markdown flavors: CommonMark, GFM, MDX
CommonMark: Standard specification.
GFM: GitHub extension with tables, checklists, strikethrough, autolinks.
MDX: Markdown + JSX. Import React components in Markdown. Used in Next.js, Docusaurus.
R Markdown: Executable R code for data science reports.
Obsidian: Wikilinks ([[page]]), callouts, YAML metadata.
NexTools Markdown editor: live preview
- Write left, see rendered HTML right
- Syntax highlighting
- GFM support (tables, checklists, strikethrough)
- Copy resulting HTML for emails, CMS, blogs
- All in browser, no data sent
Count words with the NexTools word counter.
Best practices for writing Markdown
1. One H1 per document. Multiple H1s confuse SEO and accessibility.
2. Blank lines between elements. Improves source readability, prevents render errors.
3. Lists for 3+ items. Instead of "You need X, Y, and Z", use bullets.
4. Alt text on images. Always fill: . Accessibility + SEO.
5. Specify language on code blocks. ```python activates syntax highlighting.
6. Avoid unnecessary HTML. If Markdown can do it, use Markdown. HTML reduces portability.
Try this tool:
Open tool→Frequently asked questions
Are Markdown and HTML the same thing
No. Markdown is simplified syntax that CONVERTS to HTML. You write # Title and it becomes <h1>Title</h1>. Markdown is easier to write/read; HTML is more powerful.
Where can I use Markdown
GitHub, documentation tools, blogs (Jekyll, Hugo, Next.js), note apps (Obsidian, Notion), messaging (Slack, Discord, Reddit). Most universal text format among developers.
What is GFM (GitHub Flavored Markdown)
GitHub's extension adding tables, checklists, strikethrough, autolinks, and code blocks with language. Most widely used flavor.
Can I use Markdown for complex documents like Word
For simple-medium docs, yes. For complex layout (columns, headers/footers, TOC), use Pandoc to convert Markdown to Word/PDF with templates.
How do I add an image in Markdown
. For local images: . For web: .
Does Markdown support colors or CSS styles
Not natively. You can use inline HTML (<span style='color:red'>text</span>) in supporting renderers, but this reduces portability.