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.
Links and images
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: . 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.