return (

/ Schema.org JSON-LD /

for collapsible sections, for keyboard shortcuts, or complex table layouts with colspan. However, security-conscious platforms like GitHub sanitize HTML and remove script tags, event handlers, and certain elements. Raw HTML reduces portability across Markdown renderers.', , , ], ),

/>

/ Breadcrumb Navigation /

Home / Blog / Markdown Cheat Sheet

/ Article Header /

# Markdown Cheat Sheet: Complete Syntax Guide

Text Processing March 7, 2026 15 min read

/ Article Content /

What Is Markdown and Why Use It?

Markdown is a lightweight markup language created by John Gruber in 2004 that lets you write formatted text using plain text syntax. Instead of clicking toolbar buttons or writing HTML tags, you use simple characters like # for headings, ** for bold, and - for lists. The syntax is designed to be readable even as raw text.

Markdown has become the standard for developer documentation, README files, blog posts, technical writing, and note-taking. It is used on GitHub, GitLab, Stack Overflow, Reddit, Notion, Obsidian, Jupyter notebooks, and thousands of other platforms. Learning Markdown is one of the highest-leverage skills a developer can acquire.

To practice and preview Markdown as you type, use our Markdown Preview tool. It renders your Markdown in real time, entirely in your browser.

Headings

Use hash symbols (#) to create headings. The number of hashes determines the heading level (1-6). Always leave a space between the hash and the heading text. Good practice is to use only one H1 per document.

`# Heading 1 (H1)

Heading 2 (H2)

Heading 3 (H3)

Heading 4 (H4)

Heading 5 (H5)

Heading 6 (H6)

Heading 1

Heading 2 ---------`

Text Formatting (Emphasis)

`Italic text or italic text Bold text or bold text Bold and italic or bold and italic Strikethrough text (GFM extension) ==Highlighted text== (some parsers)

Use the `console.log()` function.

H~2~O (subscript) X^2^ (superscript)`

Prefer for italic and * for bold. The underscore variants can cause issues mid-word (e.g., file_name_here might be parsed as italic in some renderers). Strikethrough with ~~ is a GitHub Flavored Markdown (GFM) extension supported on most platforms.

Links and Images

` BytePane [BytePane](https://bytepane.com/ "Developer Tools")

BytePane

https://bytepane.com/


![Logo][logo] [logo]: /images/logo.png "BytePane Logo"`

Always include descriptive alt text for images -- it improves accessibility and SEO. Reference-style links are useful in documents with many URLs because they keep the body text clean and make link management easier. If your URLs contain special characters, remember to URL-encode them.

Lists

`

• Item 1
• Item 2
  • Nested item 2a
  • Nested item 2b
    • Deeply nested

• Item 3

• First item

• Second item

• Third item

  1. Sub-item 3a
  2. Sub-item 3b

• First

• Second (still renders as 2)

• Third (still renders as 3)

• [x] Write the article

• [x] Add code examples
• [ ] Review and publish
• [ ] Promote on social media

Term : Definition of the term`

Nest list items by indenting with 2 or 4 spaces (depending on the parser). Task lists with checkboxes are a GFM extension and are widely used in GitHub issues, pull request descriptions, and project management. For numbered lists, using 1. for every item makes reordering easier since you do not need to renumber.

Code Blocks and Syntax Highlighting

Inline code uses single backticks. Code blocks use triple backticks (fenced code blocks) or 4-space indentation. Fenced code blocks support syntax highlighting by specifying the language after the opening backticks.

Run \npm install` to install dependencies.

```javascript function greet(name) return `Hello, $name!`;

```

```python def greet(name): return f"Hello, name!" ```

```json

"name": "BytePane", "tools": 50, "free": true

```

function oldStyle() return "no syntax highlighting";

```diff

• const old = "removed line";
• const new = "added line"; ````

Popular language identifiers include: javascript, typescript, python, bash, json, html, css, sql, yaml, go, rust, diff. For JSON-specific formatting, our JSON Formatter provides more features than basic code blocks. Compare code differences with our Diff Checker.

Tables

Tables are a GFM extension. Use pipes (|) to separate columns and hyphens (-) to create the header separator. Control alignment with colons in the separator row.

` | Tool | Category | Link | | --- | --- | --- | | JSON Formatter | Data | Open | | Regex Tester | Text | Open | | Color Converter | Design | Open |

Tables do not need to be perfectly aligned in the source -- most renderers normalize the spacing. For complex data, consider linking to a JSON representation instead. Our JSON Formatter can help format the data for embedding.

Blockquotes and Horizontal Rules

`

This is a blockquote. It can span multiple lines.

Nested blockquotes:

This is a nested quote.

Three levels deep.

Tip: You can use formatting inside blockquotes, including `code`, bold, and links.

---

---

___`

Blockquotes are commonly used for quoting external sources, callout boxes, and important notes. GitHub renders blockquotes with special styling when they start with keywords like [!NOTE], [!WARNING], or [!TIP].

`

[!NOTE] This is a note with special styling on GitHub.

[!WARNING] This is a warning callout.

[!TIP] This is a helpful tip.

[!IMPORTANT] Critical information goes here.

[!CAUTION] Proceed with care.`

HTML in Markdown

Most Markdown parsers allow raw HTML for features that Markdown does not support natively. This is useful for collapsible sections, keyboard shortcuts, complex layouts, and custom styling.

`

Click to expand

Hidden content goes here. You can use Markdown inside HTML blocks.

Press Ctrl + C to copy.

Centered Heading

Centered paragraph text.

Colored text

Line one Line two (same paragraph)`

Be aware that HTML support varies across platforms. GitHub sanitizes HTML and removes <script> tags and event handlers. If you are writing HTML-heavy content, consider using our HTML Formatter to optimize the output.

Footnotes, Abbreviations, and Advanced Syntax

` This claim needs a source[^1]. Another referenced fact[^note].

[^1]: Source: RFC 7231, Section 6. [^note]: This is a longer footnote with multiple paragraphs.

Indent continuation lines with 4 spaces.

The HTML specification is maintained by the W3C.

[HTML]: HyperText Markup Language [W3C]: World Wide Web Consortium

:rocket: :fire: :thumbsup: :warning:

[[toc]]

[TOC]

\Not italic\ \# Not a heading \Not a link\`

Footnotes are part of the GFM specification and are supported on GitHub, GitLab, and most static site generators. They automatically create numbered references at the bottom of the document with back-links. Emoji shortcodes are replaced with actual emoji characters on platforms that support them.

Markdown for README Files

A well-structured README is the front door to any open-source project. Here is a template that covers all the essential sections using the Markdown syntax from this guide.

`# Project Name

Brief description of the project in one or two sentences.

Features

• Feature one with bold emphasis
• Feature two with `code` highlighting
• Feature three with link to docs

Installation

```bash npm install project-name ```

Usage

```javascript

feature.run(); ```

API Reference

Contributing

1. Fork the repository
2. Create a feature branch
3. Submit a pull request

License

MIT`

Test your README rendering with our Markdown Preview tool before pushing to GitHub. You can also validate any JSON configuration files referenced in your project documentation.

Markdown Editors and Tools

Tool Type Best For Platform

VS CodeIDECode + docs workflowAll ObsidianNotes appKnowledge base, PKMAll TyporaWYSIWYG editorLong-form writingAll BytePane PreviewOnlineQuick preview, no installBrowser StackEditOnlineCollaborative editingBrowser pandocCLIFormat conversionAll

For quick previews without installing anything, our Markdown Preview tool renders your Markdown in real time with GFM support. It is perfect for testing README files, documentation drafts, and blog posts before publishing.

Markdown Best Practices

• Use ATX headings consistently -- Stick to # syntax rather than underline syntax. It is clearer, more widely supported, and easier to search.
• Leave blank lines around blocks -- Put a blank line before and after headings, code blocks, lists, and blockquotes. This prevents parsing ambiguities across different Markdown engines.
• Use fenced code blocks with language identifiers -- Always specify the language for syntax highlighting. It makes code dramatically more readable.
• Keep lines under 120 characters -- While Markdown wraps automatically, shorter lines make diffs cleaner and the source easier to read in editors.
• Use reference-style links for long documents -- They keep the body text clean and make link updates easier since each URL appears only once.
• Always add alt text to images -- This improves accessibility, SEO, and provides context when images fail to load.
• Test across renderers -- Different platforms parse Markdown slightly differently. Preview your content on the target platform before publishing. Use our Markdown Preview for quick testing.
• Use a linter -- Tools like markdownlint enforce consistent style and catch common errors like duplicate headings, trailing spaces, and missing blank lines.

Frequently Asked Questions

What is the difference between Markdown and GitHub Flavored Markdown (GFM)?

Standard Markdown (CommonMark) defines the basic syntax for headings, paragraphs, links, images, emphasis, code, and blockquotes. GitHub Flavored Markdown (GFM) extends CommonMark with tables, task lists (checkboxes), strikethrough text, autolinked URLs, syntax-highlighted fenced code blocks, and footnotes. GFM is used on GitHub, GitLab, and many documentation platforms.

How do I create a table in Markdown?

Use pipes (|) to separate columns and hyphens (-) to create the header row separator. For alignment, add colons: :--- for left-align, :---: for center, ---: for right-align. Tables are a GFM extension and are supported on most platforms including GitHub, GitLab, and many static site generators.

Can I use HTML inside Markdown?

Yes, most Markdown parsers allow inline HTML for features that Markdown does not support natively, such as <details> for collapsible sections, <kbd> for keyboard shortcuts, or complex table layouts. However, security-conscious platforms like GitHub sanitize HTML and remove script tags and event handlers. Raw HTML reduces portability across Markdown renderers.

/ CTA Section /

Preview Your Markdown Now

Write Markdown on the left, see the rendered output on the right. Our free Markdown Preview tool supports GFM tables, code highlighting, task lists, and more. No signup, no data collection, everything runs in your browser.

Open Markdown Preview

/ Related Articles /

Related Articles

[

JSON Formatting Guide

Format, validate, and minify JSON like a pro.

](/blog/json-formatting-guide/) [

Regex Cheat Sheet

Regular expression patterns every developer needs.

](/blog/regex-cheat-sheet/) [

Color Formats Explained

HEX, RGB, HSL and when to use each format.

](/blog/color-formats-hex-rgb-hsl/) [

HTTP Status Codes Guide

Every HTTP status code explained with real-world context.

](/blog/http-status-codes-guide/)

)

---

Originally published on bytepane.com. Visit for free interactive calculators and tools.