No history yet

Introduction to Markdown

Formatting for Humans

Imagine you're writing an email. You might use an asterisk to emphasize a word, like this, or type a dash to start a list. You're already using a simple system to add structure to your plain text. That's the core idea behind Markdown.

Markdown is a lightweight markup language created to be as readable as possible. The goal is simple: format text for the web without the fuss. Instead of complex code, you use punctuation characters that you already know.

The overriding design goal for Markdown’s formatting syntax is to make it as readable as possible. The idea is that a Markdown-formatted document should be publishable as-is, as plain text, without looking like it’s been marked up with tags or formatting instructions.

Compared to HTML

If you've ever peeked at the code behind a webpage, you've seen HTML (HyperText Markup Language). It uses tags, like <h1> for a main heading or <li> for a list item, to structure content. It's powerful, but it can make the raw text hard to read.

Markdown offers a simpler path. Let's say you want to create a heading. In HTML, you'd write this:

<h1>My Shopping List</h1>

In Markdown, you just do this:

# My Shopping List

See the difference? The Markdown version looks clean, like something you'd naturally type in a text file. Behind the scenes, software often converts your Markdown into HTML so a web browser can display it correctly. It’s a convenient shortcut, not an HTML replacement.

Lesson image

Where You'll See It

Because of its simplicity, Markdown is used everywhere. It's the standard for writing documentation on code-hosting sites like GitHub. Many blogging platforms, note-taking apps, and online forums use it to let users format their posts and comments without needing to know HTML.

It lets you focus on the writing itself. You can create rich, structured documents quickly without taking your hands off the keyboard to click formatting buttons. This makes it a favorite tool for writers, developers, and anyone who needs to get ideas down fast.

Time to check your understanding of these core concepts.

Quiz Questions 1/4

What is the primary goal of Markdown?

Quiz Questions 2/4

True or False: Markdown files are often converted into HTML to be displayed in a web browser.

In the next section, we'll dive into the specific syntax you'll use to format your own text.