WebGroundwebground.app
Info & Guides · Developer Reference

Markdown Cheat Sheet with Live Preview

Learn Markdown syntax for headings, lists, links, tables, and code blocks from a quick reference, then try it in a live preview editor.

Live preview editor

Preview

Welcome to Markdown

Markdown turns plain text into formatted text. This paragraph has bold, italic, and crossed-out words, plus some inline code.

Lists
  • First item

  • Second item

    • Nested item

  1. Step one

  2. Step two

  • Finished task

  • Open task

Quote, link, and table

Simple things should be simple.

Read more at example.com.

FruitPrice
Apple1.20
Pear0.90
js
function greet(name) {
  return "Hello, " + name;
}

Sample picture

The preview runs in your browser. Raw HTML is shown as text, images appear as placeholders, and only http, https, and mailto links can be clicked.

Syntax reference

Showing 30 of 30
  • **bold text**
    What it does
    Bold text. Two underscores on each side work too.
  • *italic text*
    What it does
    Italic text. One underscore on each side works too.
  • ***bold and italic***
    What it does
    Bold and italic together, using three asterisks.
  • ~~crossed out~~
    What it does
    Text with a line through it, using two tildes on each side.
  • First paragraph. Second paragraph.
    What it does
    Leave a blank line between blocks of text to start a new paragraph.
  • First line\ Second line
    What it does
    A backslash at the end of a line, or two spaces there, starts a new line inside the same paragraph.
  • \*not italic\*
    What it does
    A backslash before a Markdown symbol shows the symbol itself.
  • # Heading 1
    What it does
    Top-level heading. Put a space after the number sign.
  • ## Heading 2
    What it does
    Second-level heading, for main sections.
  • ### Heading 3
    What it does
    Third-level heading, for subsections.
  • ###### Heading 6
    What it does
    The smallest heading. Levels go from one to six number signs.
  • Heading 1 ========= Heading 2 ---------
    What it does
    Alternative style: underline the text with equals signs for level 1 or hyphens for level 2.
  • - First item - Second item - Third item
    What it does
    Bulleted list. Start each line with a hyphen, asterisk, or plus sign.
  • 1. First item 2. Second item 3. Third item
    What it does
    Numbered list. Start each line with a number and a period.
  • - Parent item - Child item - Child item
    What it does
    Indent an item by two or more spaces to nest it under the item above.
  • - [x] Finished task - [ ] Open task
    What it does
    Checklist with checked and unchecked boxes.
  • [link text](https://example.com)
    What it does
    Link with the visible text in square brackets and the address in parentheses.
  • [link text](https://example.com "Tooltip")
    What it does
    Link with a tooltip, written in quotes after the address.
  • <https://example.com>
    What it does
    Angle brackets turn a web address into a link.
  • What it does
    Angle brackets turn an email address into a mail link.
  • ![alt text](https://example.com/image.png)
    What it does
    Image. Written like a link with an exclamation mark in front; the bracket text describes the image.
  • `inline code`
    What it does
    Code inside a sentence, wrapped in backticks.
  • `` code with a ` backtick ``
    What it does
    Use double backticks when the code itself contains a backtick.
  • ``` code block ```
    What it does
    Block of code between two lines of three backticks. The text inside is kept as typed.
  • ```js console.log("Hi"); ```
    What it does
    Add a language name after the opening backticks so editors can highlight the code.
  • > Quoted text
    What it does
    Quoted text. Start the line with a greater-than sign.
  • > Quoted text >> Nested quote
    What it does
    Add another greater-than sign to quote inside a quote.
  • ---
    What it does
    Dividing line. Put three or more hyphens, asterisks, or underscores on their own line.
  • | Name | Qty | | --- | --- | | Apple | 3 | | Pear | 5 |
    What it does
    Table. Separate columns with pipes and put a row of hyphens under the header.
  • | Left | Center | Right | | :--- | :---: | ---: | | a | b | c |
    What it does
    Colons in the divider row align a column left, center, or right.

What Markdown Is

Markdown is a plain-text way to write formatted documents. A few symbols typed around ordinary words mark headings, emphasis, lists, links, and code, and the text stays readable even before it is converted.

It is used for README files, documentation, note-taking apps, chat messages, and many blogging tools. The editor above shows how each piece of syntax is rendered as you type.

Tips for Clean Markdown

Most problems come from spacing rather than from the symbols themselves.

  • Put a space after the number signs of a heading and after a list marker.
  • Leave a blank line before and after headings, lists, quotes, and code blocks.
  • Indent nested list items so they line up with the text of the item above.
  • Put a backslash before a symbol such as * or _ to show it as it is.

Frequently Asked Questions

Does Markdown look the same everywhere?+

The basics do. Headings, emphasis, lists, links, and code follow the CommonMark standard almost everywhere. Tables, task lists, and strikethrough are extensions made popular by GitHub, so a few apps do not support them.

Why doesn't the preview run my HTML or load my images?+

The preview is limited on purpose. Raw HTML is shown as text, images appear as labeled placeholders instead of being downloaded, and only http, https, and mailto links can be clicked.

Is the text I type sent anywhere?+

No. The preview is produced in your browser, and the text is not uploaded or saved.

Explore More on WebGround

View all