Home › Developer Tools › Markdown Cheat Sheet

Markdown Cheat Sheet

Every Markdown element with an example you can edit: change the text on the left and the rendered result updates instantly on the right. Covers basic syntax, GitHub Flavored Markdown (tables, task lists, strikethrough) and GitHub extras like alerts and footnotes.

Last updated:

Edit any example: the preview updates as you type and your edits are kept in this browser. Badges show where the syntax works.

Advertisement
Advertisement

How to use the Markdown Cheat Sheet

  1. Find the element you need by searching (table, image, footnote) or by choosing a tab such as Basic or GitHub extras.
  2. Edit the example in the Markdown box. The preview next to it updates as you type.
  3. Check the badge to see where the syntax works: Basic works in every Markdown app, GFM in GitHub-style renderers, GitHub only on GitHub.
  4. Copy the Markdown into your README, docs or notes, or copy the HTML output.
  5. Reset an example to get the original back after experimenting.

Markdown quick reference

ElementMarkdownSupport
Heading# H1 · ## H2 · ### H3Everywhere
Bold / italic**bold** · *italic* · ***both***Everywhere
Link[text](https://example.com)Everywhere
Image![alt text](image.png)Everywhere
Bullet list- itemEverywhere
Numbered list1. itemEverywhere
Quote> quoteEverywhere
Inline code`code`Everywhere
Code block```js … ```GFM / CommonMark
Horizontal rule---Everywhere
Table| A | B | + | --- | --- |GFM
Task list- [ ] todo · - [x] doneGFM
Strikethrough~~text~~GFM
Footnotetext[^1] + [^1]: noteGitHub, many static site generators
Alert> [!NOTE]GitHub, some docs tools

Markdown flavors compared

Original Markdown (John Gruber, 2004) defined the basics but left many edge cases open, so early renderers disagreed. CommonMark (2014) is a strict, unambiguous specification of that core syntax with a large test suite. GitHub Flavored Markdown (GFM) is a superset of CommonMark that adds tables, task lists, strikethrough, extended autolinks and filtering of unsafe HTML. Platforms then add their own extras: GitHub supports alerts, footnotes, emoji shortcodes, Mermaid diagrams and LaTeX math with $…$; tools like Obsidian add wiki links ([[Page]]) and highlights (==text==). When a document must look the same everywhere, stick to the Basic and GFM elements.

Tips for clean Markdown

  • Leave a blank line before and after headings, lists, code blocks and tables; many renderers require it.
  • Always put a space after # in headings: #Heading is not a heading in CommonMark.
  • Use one style consistently: - for bullets, ** for bold and * for italics.
  • Add a language after the opening backticks (```python) so code is highlighted.
  • Write meaningful alt text for images; screen readers read it aloud.

Frequently asked questions

What is Markdown?

Markdown is a lightweight markup language created by John Gruber in 2004. You format plain text with simple symbols, such as # for headings and ** for bold, and a renderer converts it to HTML. It is used for README files, documentation, forums, chat apps and note-taking tools.

What is GitHub Flavored Markdown (GFM)?

GFM is GitHub's specification of Markdown, built on CommonMark. It adds tables, task lists, strikethrough with ~~, automatic links for URLs and stricter rules for raw HTML. Most modern tools such as GitLab, VS Code and many static site generators support it.

How do I make a line break in Markdown?

A single newline inside a paragraph is ignored by most renderers. End the line with two spaces or a backslash to force a line break, or leave a blank line to start a new paragraph. GitHub comments and issues are an exception: there a single newline becomes a break.

How do I create a table in Markdown?

Write the header row separated by pipes, then a separator row of dashes such as | --- | --- |, then one row per line. Add colons in the separator to align a column: :--- left, :---: center and ---: right. Tables are part of GFM, not original Markdown.

How do I add a checkbox in Markdown?

Start a list item with - [ ] for an unchecked box or - [x] for a checked one. These task lists are a GFM feature; on GitHub you can tick them directly in issues and pull requests.

How do I escape Markdown characters?

Put a backslash before the character, for example \* to show a literal asterisk or \# at the start of a line to avoid a heading. Characters that can be escaped include \ ` * _ { } [ ] ( ) # + - . ! and |.

Can I use HTML inside Markdown?

Yes, most renderers pass simple HTML through, which is useful for things Markdown lacks, such as <kbd>, <sup>, <details> or image sizes. Platforms like GitHub remove scripts, styles and many attributes for security, so stick to basic tags.

Are all the tools on FreeToolCabin tested for quality and accuracy?

Yes! Every tool on our site undergoes automated Q/A testing in real browser environments to ensure high precision, correct output, and zero errors. If you happen to spot a bug or have a suggestion, please contact us at [email protected] and our team will review it right away.

Related tools

Markdown EditorWrite Markdown with a toolbar, live split preview, autosave and .md or HTML export.Markdown to HTMLConvert Markdown to clean HTML with a live editor.Markdown Table GeneratorBuild Markdown tables in a grid or paste from Excel/CSV, with alignment and preview.Git Cheat SheetSearchable Git command reference by task, with copy buttons and an undo/rename/fix wizard.Discord Text FormatterFormat Discord messages with bold, spoilers, headers, quotes, lists and code blocks, with live preview.Folder Tree GeneratorTurn a local folder or an indented list into an ASCII directory tree for your README.Online Python CompilerRun Python 3 in your browser with input(), numpy, pandas, charts and share links.JSON EditorEdit JSON in a tree and as code side by side: add, rename, drag, change types, undo and download.Unzip FilesOpen and extract ZIP files online.RAR & 7z ExtractorOpen RAR, 7z and other archives online and extract files.Regex TesterTest and debug regular expressions live.File Info ViewerCheck file size, type, date and MD5/SHA hashes.SQLite ViewerOpen .db and .sqlite files in your browser, browse tables and run SQL queries.DOCX ViewerOpen and read Word .docx files in your browser, then print or save them as HTML.EPUB ReaderOpen and read EPUB e-books in your browser with pages, a table of contents and font controls.What Is My BrowserSee your browser, version, OS, engine, screen and which web features it supports.Font ViewerPreview TTF, OTF, WOFF and WOFF2 fonts with sample text, waterfall, glyphs and metadata.Regex Cheat Sheet75+ ready-to-use regex patterns for emails, URLs, IPs and dates, each with a live test box.JavaScript Keycode FinderPress any key to see its JavaScript key, code, keyCode, which, location and modifiers.QR Code ScannerScan QR codes with your camera or from an image and safely read the link or text.RAID CalculatorUsable capacity, efficiency and fault tolerance for RAID 0, 1, 5, 6, 10, 50 and 60 arrays.JSONPath TesterTest JSONPath expressions live: filters, slices, wildcards and recursive search, with matches highlighted.Mermaid Diagram EditorWrite Mermaid code and see flowcharts, sequence, Gantt and ER diagrams live. Export SVG or PNG.Country Codes ListSearch ISO 3166 alpha-2, alpha-3 and numeric country codes with calling codes and TLDs.CSS Selector TesterTest CSS selectors on your HTML: highlighted matches, match count and specificity.HAR File ViewerOpen a .har file to see a waterfall timeline, headers, bodies, timings and size totals.jq PlaygroundRun jq filters on JSON in your browser with live output, flags and an example library.Regex ExplainerPaste a regular expression and get a plain-English breakdown, railroad diagram and flag notes.XPath TesterTest XPath expressions on XML or HTML: highlighted matches, node paths, values and examples.EML File ViewerOpen .eml email files to read the message, headers and raw source and save attachments.Graphviz Online ViewerWrite Graphviz DOT code and render graphs live; switch layout engines, export SVG or PNG.JavaScript Online CompilerWrite and run JavaScript in your browser with a console, timing, error lines and share links.Jupyter Notebook ViewerOpen .ipynb files and read code, Markdown, math, tables, plots and errors without Python.LaTeX Table GeneratorEdit a table like a spreadsheet or paste from Excel and get LaTeX tabular or booktabs code.Log File ViewerOpen huge log files with level colors, regex and time filters, JSON pretty-print and tail -f.Logic Gate SimulatorBuild logic circuits with AND, OR, NOT, XOR gates and flip-flops; see live outputs and truth tables.MSG File ViewerOpen Outlook .msg emails in your browser: sender, recipients, body, headers and attachments.Online Code EditorVS Code-style editor in your browser: tabs, 50+ languages, find/replace, autosave.Diff ViewerPaste a git diff or .patch file and view it side by side or inline, with file navigation.EditorConfig GeneratorBuild an .editorconfig with indent, charset, line endings and trim rules per file pattern.Folder Compare ToolCompare two folders by file list, size and SHA-256 hash, then open a text diff of changed files.Glob Pattern TesterTest glob patterns like **/*.js, {a,b} and !exclusions against a list of file paths.JMESPath TesterEvaluate JMESPath expressions against JSON live, the query language used by the AWS CLI.MongoDB Query TesterTest MongoDB find filters, projections and aggregation pipelines on sample JSON documents.Semantic Version CalculatorBump, compare, sort and test SemVer versions against npm ^, ~ and x ranges.XSLT TesterRun an XSLT 1.0 stylesheet on XML in your browser and see the output as HTML, XML or text.ASCII Diagram EditorDraw boxes, arrows and text on a character grid and copy plain-text diagrams for code and READMEs.DBF File ViewerOpen dBase .dbf files and shapefile tables, search and sort records, export CSV or XLSX.MBOX File ViewerOpen .mbox mail archives: list and search messages, read them, save attachments, export EML.MDB File ViewerOpen Access .mdb and .accdb databases in your browser: list tables, view rows, export CSV.Shapefile ViewerView zipped shapefiles on a map with the attribute table, then export to GeoJSON or CSV.Online Hex EditorOpen any file as hex and ASCII, edit bytes, search, inspect values and save the result.PHP Online CompilerRun PHP 8 code in your browser with output, HTML preview, error lines and share links.PlantUML EditorWrite PlantUML and see sequence, class, activity and more diagrams live. Export SVG or PNG.Sorting Algorithm VisualizerWatch bubble, insertion, merge, quick, heap and radix sort step by step with live counters.Lottie ViewerOpen Lottie JSON or .lottie files to play, pause, scrub frames, change speed and see details.
See all 53 Code Playgrounds & Testers →