How to Write Markdown: A Step-by-Step Guide for Beginners

What You Need

To follow this guide, you only need two things:

1. A web browser (Chrome, Safari, Firefox, or Edge)
2. 5 minutes of your time

No software to install. No account to create. Just open a Markdown editor and start typing.

Open our free online Markdown editor in a new tab and follow along. The preview updates instantly as you type.

Step 1: Open a Markdown Editor

Before you can write Markdown, you need somewhere to write it. A Markdown editor is a tool that shows you both the raw text and the formatted result.

For this guide, we recommend:

1. Visit MarkdownMaster Editor
2. You will see a split screen: the left side is the editor (where you type), and the right side is the preview (where you see the result)
3. Clear the example content and you are ready to go

Pro tip: If you prefer a distraction-free experience, you can resize the panels by dragging the divider in the middle.

Step 2: Write a Heading

In Markdown, headings are created with the # symbol. The more # symbols you add, the smaller the heading.

Try it now: In the editor, type:

# My First Markdown Document

You should see a large heading appear in the preview panel. This is an H1 tag in HTML terms — the main title of your document.

Now try adding a section with a smaller heading:

## Introduction

This creates an H2 — a section-level heading. You can go all the way down to six # symbols for the smallest heading.

Step 3: Add a Paragraph

This is the easiest part. In Markdown, plain text is already a paragraph. Just write normally:

This is a paragraph. It contains several sentences
but as long as there is no blank line, it stays as
one paragraph.

To start a new paragraph, add a blank line:

This is the first paragraph.

This is a separate paragraph.

Key rule: A blank line (press Enter twice) creates a new paragraph. A single line break within a paragraph is ignored by most Markdown renderers — unless you end the line with two spaces.

Step 4: Make Text Bold and Italic

Markdown uses simple punctuation marks to add emphasis:

Bold text: Wrap your text in ** (two asterisks):

This is **important** information.

Preview: This is important information.

Italic text: Wrap your text in * (one asterisk):

She *really* meant it.

Preview: She really meant it.

Bold + Italic: Use *** (three asterisks):

This is ***very important***.

Preview: This is very important.

Memory trick: Think of it like volume levels — one asterisk for emphasis (italic), two for strong emphasis (bold), three for screaming (bold italic).

Step 5: Create a List

Lists are where Markdown really shines — they are incredibly easy to write.

Unordered list: Start each line with - and a space:

- First item
- Second item
- Third item

Ordered list: Start each line with a number and a period:

1. Step one
2. Step two
3. Step three

Nested list: Indent with two spaces:

- Main item
  - Sub-item one
  - Sub-item two
- Another main item

Step 6: Add a Link

Links in Markdown use a simple pattern: [text](url).

Check out [MarkdownMaster](https://markdownmaster.site).

Preview: Check out MarkdownMaster.

You can also add a title attribute that shows up on hover:

[Visit us](https://markdownmaster.site "MarkdownMaster Home")

Pro tip: If you link to the same URL multiple times, use reference-style links:

I use [MarkdownMaster][mm] every day.
Have you tried [MarkdownMaster][mm]?

[mm]: https://markdownmaster.site

Step 7: Insert an Image

Images use the same syntax as links, but with an exclamation mark (!):

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

The text inside the square brackets is called "alt text" — it is displayed when the image cannot load and is used by screen readers for accessibility.

You can also add title text:

![Markdown logo](https://example.com/markdown-logo.png "The Markdown Logo")

Pro tip: Always include descriptive alt text. It helps both SEO and accessibility.

Step 8: Write a Code Block

To write code inside a sentence, wrap it in single backticks:

Use the `printf()` function to print text.

Preview: Use the printf() function to print text.

For multi-line code blocks, use triple backticks with a language name:

```python
def hello():
    print("Hello, Markdown!")

hello()
```

The language name after the opening backticks tells the renderer which syntax highlighting rules to apply. Common options: javascript, python, html, css, bash, sql.

Step 9: Add a Blockquote

Blockquotes are used to highlight quotes, notes, or callouts. Use the > symbol:

> This is a blockquote.
> It can span multiple lines.

Preview:

This is a blockquote. It can span multiple lines.

For nested blockquotes, add additional > symbols:

> Main quote
>
> > Nested quote

Step 10: Create a Table

Tables are slightly more complex but still easy once you know the pattern. Use pipes (|) for columns and dashes (-) for the header separator:

| Feature | Description |
|---------|-------------|
| Speed   | Instant preview |
| Price   | Free          |
| Sign-up | Not required  |

The preview will render this as a neatly aligned table.

For alignment control, add colons in the separator row:

| Left | Center | Right |
|:-----|:------:|------:|
| a    | b      | c     |

Full Example: Putting It All Together

Here is a complete Markdown document that uses everything you learned:

# My Recipe Book

A collection of my favorite recipes.

## Pasta Carbonara

This is a classic Italian dish. **Quick, easy, and delicious.**

### Ingredients

- 200g spaghetti
- 100g pancetta
- 2 eggs
- Parmesan cheese

### Instructions

1. Boil the pasta in salted water.
2. Fry the pancetta until crispy.
3. Mix eggs with grated Parmesan.
4. Combine everything *off the heat*.

> Pro tip: Never add cream to carbonara.
> Traditional recipes use only eggs and cheese.

Enjoy your meal!

Try copying this into the MarkdownMaster Editor and see how it looks!

Next Steps

Congratulations! You now know the basics of Markdown. Here is what to do next:

1. Practice — Open the free online editor and experiment with different syntax
2. Read the full cheat sheet — Check out our complete Markdown cheat sheet for advanced syntax like footnotes, task lists, and definition lists
3. Use it daily — Markdown is used everywhere: GitHub, Reddit, Notion, Discord, and most documentation tools