What Is Markdown and How Do You Use It

Writing That Becomes Web Pages

Markdown is a way to write and format text using simple symbols you can type on any keyboard. Instead of clicking buttons in a word processor, you add marks like ** for bold or # for a heading. A tool then reads those marks and turns them into a properly formatted webpage.

Think of it like a recipe. You write the ingredients and steps in plain language, and the oven (in this case, a Markdown converter) does the cooking. You don't need to know how the oven works — just the recipe language.

Here's the key idea: Markdown is plain text with simple rules. You can write it in any text editor — Notepad, TextEdit, VS Code, or even your phone's notes app. When you're ready, you convert it, and it turns into a polished document or web page.

Why Writers and Builders Love It

Markdown has become the language of the internet because it's simple, fast, and portable. Bloggers use it. Developers use it to write documentation. Students use it for notes. Even AI tools use Markdown to format their responses.

The biggest advantage? Your writing stays readable forever. A Word document from 1995 might not open properly today. A Markdown file from 1995 still opens perfectly — because it's just plain text.

It's also platform-independent. Write Markdown once, and it can be converted into a blog post, a PDF, an email, or a presentation. You're writing the content, and the tool handles the design.

The Basic Rules in Five Minutes

Markdown uses symbols that don't get in the way of reading. Here's the most common ones you'll use every day:

From Plain Text to a Web Page

Here's what a real Markdown document looks like. On the left is what you type; on the right is what it becomes when converted. You can see how readable the source is — anyone can understand it, even before conversion.

# My First Project

Welcome to my project! This is a **bold** statement.

## What It Does

I built this because:
- It's fast
- It's simple
- It works everywhere

## Get Started

1. Open the folder
2. Run `npm install`
3. Start the app with `npm start`

> "The best code is no code at all." — Jeff Atwood

The same content, converted into HTML (what a web browser reads):

<h1>My First Project</h1>

<p>Welcome to my project! This is a <strong>bold</strong> statement.</p>

<h2>What It Does</h2>

<p>I built this because:</p>
<ul>
  <li>It's fast</li>
  <li>It's simple</li>
  <li>It works everywhere</li>
</ul>

<h2>Get Started</h2>
<ol>
  <li>Open the folder</li>
  <li>Run <code>npm install</code></li>
  <li>Start the app with <code>npm start</code></li>
</ol>

<blockquote>
  "The best code is no code at all." — Jeff Atwood
</blockquote>

You never have to write the HTML yourself. The Markdown converter does it for you. You just write the simple version on the left.

Knowledge Check

Test what you learned with this quick quiz.