Markdown is a plain-text way to write formatted documents, but you cannot see the formatting until it is rendered. A live previewer shows the formatted result beside your text as you type. This guide shows you the syntax that matters and how to preview effectively.
Why preview while you write
Without a preview, formatting errors hide until the document is published: a heading that never became a heading, a list that collapsed, a link with a broken bracket. Live preview catches these the moment they happen, while the fix is still fresh in your mind.
The essential markdown syntax
- Headings: # for a main heading, ## for a section, ### for a subsection.
- Bold and italic: **bold** with double asterisks, *italic* with single.
- Lists: dash or star at the line start for bullets, numbers for ordered lists.
- Links: [text](address).
- Images: .
- Code: backticks around inline code, triple backticks around blocks.
- Quotes: > at the line start.
Step-by-step: preview your markdown
- Write or paste your markdown into the editor side of a previewer.
- Watch the preview update as you type. If a block does not render, check its syntax first.
- Leave a blank line before and after headings, lists, and code blocks. Missing blank lines are the top cause of rendering failures.
- Check lists carefully: inconsistent indentation turns nested lists into flat ones.
- Check links and images by clicking them in the preview.
- Copy or export the rendered result when it looks right.
Common rendering failures
A heading without a space after the # symbol stays plain text. A list item without a blank line before it may join the previous paragraph. Code blocks need matching triple backticks; one missing set swallows the rest of the document. Tables need a header separator row of dashes, or they render as plain lines.
Try it the faster way
Write and preview markdown live in the tool below.
Prefer the full page? Open the live markdown previewer directly.
Quick tips
- Blank lines around blocks prevent most rendering surprises.
- Preview on a narrow screen too; long lines and tables behave differently there.
- Keep a syntax cheat sheet open until the basics are automatic.
Markdown is fastest when you can see the result instantly. A live previewer turns formatting from guesswork into something you verify as you type.
Frequently asked questions
Why does my heading not render as a heading? The most common cause is a missing space after the # symbol: “#Title” stays plain text, while “# Title” becomes a heading. The second cause is a missing blank line before the heading, which can merge it with the previous paragraph.
Do all markdown previewers render the same way? No. Markdown has dialects: GitHub-flavored markdown supports tables and task lists, while basic markdown does not. If a feature renders in one previewer but not another, the dialect is usually the reason.
Can I preview markdown offline? Yes. Many editors include live preview without any network connection, and browser-based previewers often work offline once loaded. Offline preview is handy for private documents you do not want to paste into a website.
Worked example
Write this markdown: a heading “# My Notes”, a blank line, then “- Apples” and “- Oranges”. The preview should show a large heading followed by a two-item bullet list. If the heading renders as plain text, the missing space after # is the cause. If the list merges into the paragraph above, a missing blank line is the cause. Both fixes take seconds once the preview shows the problem, which is precisely why live preview beats writing blind and discovering errors after publishing.