Markdown Syntax Guide for Beginners

Markdown is a lightweight way to format plain text using simple symbols. Instead of clicking toolbar buttons or wrestling with HTML tags, you write # for a heading, ** for bold, and - for a list item. The result is a file that's perfectly readable as plain text and easily converted into Word, PDF, HTML, or any other format. This guide walks through the essentials you'll use every day, with copy-friendly examples.

What is Markdown, and why should you use it?

Markdown was created in 2004 by John Gruber as a way to write for the web "without ever having to use <tags>." The core idea: punctuation marks do the formatting, so a Markdown file reads naturally even before it's rendered.

A few reasons beginners fall in love with Markdown:

• It's plain text. You can open .md files on any device, in any editor, decades from now. No proprietary format, no version conflicts.
• It's fast. Your hands never leave the keyboard. No mouse clicks, no formatting ribbon.
• It's portable. One Markdown source compiles to Word, PDF, HTML, slides, and more.
• It's distraction-free. You focus on words and structure, not how the page looks.

Think of Markdown as an outline that also happens to be a finished document. You describe what things are (a heading, a list, a quote), and a renderer takes care of how they look.

Headings

Use # symbols for headings. The number of hashes sets the level, from 1 (the biggest) to 6 (the smallest). Always put a space after the #.

# Heading 1 (title)
## Heading 2 (section)
### Heading 3 (subsection)
#### Heading 4

Use one # Heading 1 per document as the title, then ## for major sections and ### for sub-sections. This structure matters for accessibility and table-of-contents generators.

Paragraphs and line breaks

A paragraph is just one or more lines of text followed by a blank line. Without that blank line, Markdown treats consecutive lines as a single wrapped paragraph.

This is paragraph one.

This is paragraph two.

For a soft line break inside the same paragraph, end a line with two spaces (invisible, but required) or use a backslash \. Most beginners trip on this: a single Return doesn't force a new line in the rendered output.

Text formatting: bold, italic, and code

The basics you'll use constantly:

• Bold — wrap with double asterisks: **bold text**.
• Italic — wrap with single asterisks: *italic text*.
• Bold and italic — triple asterisks: ***both***.
• Strikethrough — double tildes (a GitHub Flavored Markdown extension): ~~deleted~~.
• Inline code — wrap in single backticks: `code`.

You can **emphasize** words, *italicize* them,
or show a `command` like `npm install`.

Use bold sparingly to mark importance; overusing it dilutes its effect. Reserve inline code for file names, commands, and identifiers — it renders in a monospace font and is easier to scan.

Lists

Lists are where Markdown really shines. There are two main types.

Unordered lists use -, *, or + — pick one and stick with it:

- Apples
- Bananas
- Cherries

Ordered lists use numbers followed by a period:

1. Preheat the oven
2. Mix the batter
3. Bake for 30 minutes

You can nest lists by indenting the child item with two or more spaces:

- Fruits
  - Apples
  - Oranges
- Vegetables
  - Carrots

GitHub Flavored Markdown also supports task lists, which render as checkboxes:

- [x] Draft the outline
- [x] Write the first section
- [ ] Proofread

Links and images

Links use square brackets for the text and parentheses for the URL: [visible text](https://example.com). Add an optional title in quotes for a tooltip on hover.

Read the [official guide](https://example.com "Optional title").

Images work the same way, with a leading !:

![Alt text describing the image](https://example.com/photo.jpg)

Always write meaningful alt text — it's read aloud by screen readers and shown if the image fails to load. If you have plain text you want to turn into a formatted Markdown note, the text to Markdown converter does it in one step.

Blockquotes

A > at the start of a line creates a blockquote, used for quoted material or callouts. You can nest quotes with multiple > symbols.

> Simplicity is the ultimate sophistication.
>
> — Leonardo da Vinci

Blockquotes render as indented, styled blocks in nearly every Markdown viewer, making them perfect for pull quotes, asides, or warnings.

Code blocks

For longer code samples, use a fenced code block with triple backticks. You can specify a language after the opening fence to enable syntax highlighting.

function add(a, b) {
  return a + b;
}

```js
function add(a, b) {
  return a + b;
}
```

If your code itself contains triple backticks, wrap the fence with four backticks instead, as shown above.

Putting it together

Here's a small note that combines everything covered so far:

# Trip Checklist

We're heading to **Lisbon** for a week. ~~Bring a coat~~ — it'll be warm.

## Packing list

- [x] Passport
- [x] Tickets
- [ ] Sunscreen
- [ ] Camera

> Booked apartment near *Alfama*. See [the map](https://example.com/map).

```js
console.log("Ready to go!");

That single readable file becomes a formatted Word document, PDF, or HTML page when you run it through a converter. Paste the same source into the [Markdown to Word](/) converter and you'll get a polished document in seconds — all processing happens locally in your browser.

## Common mistakes to avoid

| Mistake | What happens | Fix |
| --- | --- | --- |
| No space after `#` | `#Heading` won't render as a heading | Write `# Heading` |
| Forgetting a blank line between blocks | Headings and paragraphs merge together | Add an empty line |
| Single Return for a line break | Lines collapse into one paragraph | End the line with **two spaces** |
| Mixing `-`, `*`, `+` in one list | Inconsistent or broken rendering | Stick to one bullet style |
| Unescaped `*` or `_` | Accidental italic where you didn't mean it | Escape as `\*` or `\_` |
| Forgetting alt text on images | Broken accessibility and SEO | Always write a description |

## Conclusion

That's the core of Markdown: a handful of symbols that cover 95% of what most people write. Start with headings, paragraphs, lists, and links — you can produce useful documents with just those four. Add bold, italic, blockquotes, and code blocks as you need them. The best way to learn is to write a real note today. If you have existing text you'd like to convert into clean Markdown, try the [text to Markdown](/text-to-markdown) tool, and when you're ready to share it as a polished document, paste your Markdown into the [Markdown to Word](/) converter. Both run entirely in your browser, so your writing stays private.