Markdown Guide for Beginners: Syntax, Tips & Free Preview Tool

What Is Markdown?

Markdown is a lightweight text formatting language that lets you create formatted documents using plain text. It was created in 2004 by John Gruber and has become the standard writing format for developers, technical writers, and content creators.

You write simple symbols like # for headings, ** for bold, and - for lists, and they render as beautifully formatted HTML. Markdown files use the .md extension and are supported by GitHub, GitLab, Reddit, Discord, Notion, Slack, and hundreds of other platforms.

Why Learn Markdown?

For Developers

For Writers

For Everyone

Basic Markdown Syntax

Headings

Use the hash symbol followed by a space:

Bold and Italic

Lists

Unordered lists use dashes, asterisks, or plus signs:

Ordered lists use numbers followed by periods:

Nested lists add indentation (2-4 spaces):

- Child item

- Grandchild item

Links

Create links with square brackets for the text and parentheses for the URL:

Link Text

Images

Similar to links but with an exclamation mark at the start:

!Alt text

Blockquotes

Use the greater-than symbol:

> This is a blockquote. It is commonly used for quoting text or highlighting important notes.

Code

Inline code: Wrap with single backticks - Use the `console.log()` function

Code blocks: Wrap with triple backticks and optionally specify the language for syntax highlighting

Horizontal Rules

Use three or more dashes, asterisks, or underscores on a line by themselves:

---

Preview all of these elements live with our free Markdown Preview tool.

Advanced Markdown Syntax

Tables

Create tables using pipes and dashes:

Align columns using colons:

Generate Markdown tables instantly with our free Markdown Table Generator.

Task Lists

GitHub-flavored Markdown supports checkboxes:

Strikethrough

Wrap text with double tildes:

~~This text is crossed out~~

Footnotes

Add references with [^1] syntax:

This statement needs a source[^1].

[^1]: This is the footnote text.

Definition Lists

Some Markdown parsers support definition lists:

Term

: Definition of the term

Markdown Flavors

Standard Markdown

The original specification by John Gruber. Covers basic formatting.

GitHub Flavored Markdown (GFM)

Adds task lists, tables, strikethrough, auto-linking, and fenced code blocks. Used on GitHub for README files, issues, and pull requests.

CommonMark

A standardized specification that removes ambiguity from the original Markdown syntax. Many modern parsers follow CommonMark.

MDX

Markdown with JSX support. Allows you to embed React components inside Markdown files. Popular in modern documentation frameworks.

Markdown Best Practices

1. Use Consistent Formatting

Pick one style for emphasis (asterisks vs underscores), list markers (dashes vs asterisks), and heading style, then use it consistently.

2. Add Blank Lines Between Elements

Always add a blank line before and after headings, lists, code blocks, and blockquotes. This prevents rendering issues.

3. Use Headings Hierarchically

Do not skip heading levels. Go from H1 to H2 to H3. This creates a logical document structure and improves accessibility.

4. Keep Lines Reasonable

While Markdown does not require line breaks, keeping lines under 80-120 characters improves readability in text editors.

5. Use Reference Links for Repeated URLs

If you link to the same URL multiple times, use reference-style links to keep your text clean.

Where to Write Markdown

Text Editors

Online Tools

Convert Markdown to Other Formats

Free Writing and Formatting Tools

Conclusion

Markdown is a skill that pays off across your entire digital life — from writing GitHub documentation to taking personal notes. The syntax is simple, the output is clean, and it works everywhere. Start with headings, bold, lists, and links, then explore tables and code blocks as you need them. Use our free Markdown Preview to practice and see your formatting rendered in real time.