Markdown Reader

Write and preview Markdown in real-time

Markdown Input

# Markdown syntax guide

## Headers

# This is a Heading h1
## This is a Heading h2
###### This is a Heading h6

## Emphasis

*This text will be italic*  
_This will also be italic_

**This text will be bold**  
__This will also be bold__

_You **can** combine them_

## Lists

### Unordered

* Item 1
* Item 2
* Item 2a
* Item 2b
    * Item 3a
    * Item 3b

### Ordered

1. Item 1
2. Item 2
3. Item 3
    1. Item 3a
    2. Item 3b

## Images

![This is an alt text.](https://fabro.dev/_next/image?url=%2F_next%2Fstatic%2Fmedia%2Frobot.b5b59ab7.jpeg&w=384&q=75 "This is a sample image.")

## Links

You may be using [Markdown Live Preview](https://markdownlivepreview.com/).

## Blockquotes

> Markdown is a lightweight markup language with plain-text-formatting syntax, created in 2004 by John Gruber with Aaron Swartz.
>
>> Markdown is often used to format readme files, for writing messages in online discussion forums, and to create rich text using a plain text editor.

## Tables

| Left columns  | Right columns |
| ------------- |:-------------:|
| left foo      | right foo     |
| left bar      | right bar     |
| left baz      | right baz     |

## Blocks of code

```
let message = 'Hello world';
alert(message);
```

## Inline code

This web site is using `markedjs/marked`.

Preview

Markdown syntax guide

Headers

This is a Heading h1

This is a Heading h2

This is a Heading h6

Emphasis

This text will be italic
This will also be italic

This text will be bold
This will also be bold

You can combine them

Lists

Unordered

Item 1
Item 2
Item 2a
Item 2b
- Item 3a
- Item 3b

Ordered

Item 1
Item 2
Item 3
1. Item 3a
2. Item 3b

Images

This is an alt text.

Links

You may be using Markdown Live Preview.

Blockquotes

Markdown is a lightweight markup language with plain-text-formatting syntax, created in 2004 by John Gruber with Aaron Swartz.

Markdown is often used to format readme files, for writing messages in online discussion forums, and to create rich text using a plain text editor.

Tables

Left columns	Right columns
left foo	right foo
left bar	right bar
left baz	right baz

Blocks of code

let message = 'Hello world';
alert(message);

Inline code

This web site is using markedjs/marked.

How to use the Markdown Reader

•Write or paste Markdown into the editor panel on the left side. The tool supports the full CommonMark specification including GitHub Flavored Markdown (GFM) extensions.
•Preview in real-time as you type. The right panel renders your Markdown instantly, showing exactly how your document will look when published.
•Use the toolbar for quick formatting. Insert headers, bold, italic, links, images, code blocks, and tables without memorizing the syntax.
•Export your work by copying the rendered HTML or the raw Markdown source. Use the HTML output to paste directly into CMS platforms, emails, or web pages.

What is Markdown?

Markdown is a lightweight markup language created by John Gruber in 2004. It lets you write formatted text using a plain-text editor with simple, human-readable syntax. Instead of clicking buttons in a rich text editor, you use characters like # for headings, * for emphasis, and - for lists.

The beauty of Markdown is its portability. A .md file is just plain text, so it works everywhere: Git repositories, documentation platforms like Read the Docs, note-taking apps like Obsidian, and static site generators like Hugo and Jekyll. GitHub, GitLab, and Bitbucket all render Markdown files automatically, which is why README.md has become the universal standard for project documentation.

Key syntax elements include:

•Headings: # H1, ## H2, ### H3 (up to six levels)
•Emphasis: *italic*, **bold**, ~~strikethrough~~
•Lists: - or * for unordered, 1. for ordered
•Links: [text](url)
•Images: ![alt](url)
•Code: backticks for inline code, triple backticks for fenced code blocks with optional language highlighting
•Tables: pipe-delimited columns with a separator row

GitHub Flavored Markdown adds task lists (- [x]), auto-linked URLs, and syntax-highlighted code fences, making it especially powerful for developer documentation.

Common use cases

•Writing README files for open source projects on GitHub, GitLab, or Bitbucket so collaborators and users can quickly understand the project.
•Drafting blog posts for static site generators (Hugo, Jekyll, Gatsby) or headless CMS platforms that accept Markdown input.
•Creating technical documentation with code samples, tables, and structured headings that render beautifully on documentation hosting platforms.
•Taking structured notes that remain readable in any text editor and can be synced across Markdown-compatible apps like Obsidian, Notion, or Typora.

FAQ

Q: Does this tool support GitHub Flavored Markdown (GFM)? A: Yes. The renderer supports GFM extensions including task lists, tables, strikethrough, and auto-linked URLs, so your preview will closely match how GitHub renders your files.

Q: Can I use HTML inside my Markdown? A: Most Markdown parsers, including this one, allow inline HTML. You can mix HTML tags with Markdown syntax for advanced layouts, although pure Markdown is preferred for readability and portability.

Q: How do I add syntax-highlighted code blocks? A: Use triple backticks followed by the language name. For example, writing three backticks then javascript before your code and three closing backticks after will produce a highlighted JavaScript block.

Is my data safe?

Yes. This tool runs entirely in your browser. Your data is never sent to our servers.