Guide · Free · Updated Nov 18, 2026

Markdown Guide — Write and Format with Markdown

Markdown is the simplest way to write formatted text: a few plain characters turn into headings, bold text, lists and links. This guide teaches you everything you need, with examples you can try in our free Markdown Editor.

What is Markdown?

Markdown is a plain-text way to write formatted documents. Instead of clicking buttons for bold or headings, you type a few simple characters: # makes a heading, **word** makes bold, and - starts a list item. The file stays readable as plain text, and any Markdown tool turns it into proper formatted HTML. It was created for writers who wanted to focus on words, not on formatting menus — and it is now the standard for blogs, GitHub, documentation and notes. Try it in our Markdown Editor and watch the preview update as you type.

Headings and paragraphs

Headings use # signs: # is the biggest heading, ## is smaller, and ### is smaller still. Write a blank line between paragraphs, and the preview shows them as separate paragraphs. A single line break in Markdown does not make a new paragraph — you need a blank line, or two spaces at the end of a line. This is the most common surprise for beginners, and it is the reason a paragraph sometimes looks joined together in the preview.

Bold, italic and code

Wrap a word in **two stars** for bold, in *one star* for italic, and in `backticks` for code. Combine them: ***bold and italic*** uses three stars. For a block of code, put three backticks on the line before and after it. Use bold for the words that matter, italic for emphasis and foreign words, and code for file names, commands and anything a reader should type exactly.

Lists

Start a line with - or * for a bullet list, or with 1. 2. 3. for a numbered list. Indent a line with two spaces to nest it under the item above. Checklists use - [ ] for an empty box and - [x] for a ticked one — GitHub turns these into clickable checkboxes. Lists are the best way to break up a long page: readers scan a list in seconds, while a wall of text is skipped.

A link is written as [text](https://example.com) — the words in square brackets, the address in round brackets. An image is the same with a ! in front: ![description](image.jpg). The description matters: it is what screen readers announce and what shows if the image fails to load. Keep link text meaningful — "read the guide" is better than "click here" — and check every link after you paste it, because one wrong character breaks it.

Quotes, tables and lines

Start a line with > for a quote — useful for quoting someone else's words. A line of three dashes --- makes a horizontal divider between sections. Tables use | pipes: | Name | Age | on one line, | --- | --- | on the next, then one row per line. Tables are fiddly to type by hand, so write them in the editor and check the preview — a missing pipe is the usual mistake.

Where Markdown is used

Bloggers draft posts in Markdown because it converts to clean HTML for WordPress and Blogger with one copy-paste. Developers write README files, changelogs and documentation in Markdown because GitHub renders it automatically. Students use it for notes and assignments that need headings, lists and code without the weight of a word processor. If you write the same text in two places — say a blog and a newsletter — write it once in Markdown and convert it for both, instead of formatting it twice.

AdvertisementReserved ad space — AdSense ads will appear here after approval.

Advertisement — reserved ad space; AdSense ads will appear here after approval.

Frequently asked questions

Does it work on my phone?

Yes — write Markdown on mobile and see the same live preview. On a small screen the editor and preview stack vertically, and everything still works offline once the page has loaded.

Can I paste the HTML into WordPress or Blogger?

Yes — click “Copy HTML” and paste it into your blog's HTML or code view. WordPress, Blogger and most website builders accept pasted HTML, and the headings, lists and links keep their formatting.

Is the Markdown Editor free?

Yes — 100% free, no sign-up, no limits. It runs entirely in your browser.

What is Markdown used for?

Blog posts, GitHub README files, documentation, notes and video scripts — anywhere plain text needs to become formatted text.

How do I make a heading?

Put # at the start of the line: # for the biggest heading, ## for the next size, ### for the next. One # per level.

Can I download my work?

Yes — download it as a .md file to keep editing later, or as a .html file to publish on any website.

Copied!