What Is Markdown and How Does It Work
The simple text formatting language that lets anyone write for the web — no coding required.
The Easiest Way to Format Text for the Web
Imagine you want to make a word bold, add a heading, or create a list — but instead of clicking buttons in a word processor, you just type a few extra symbols. That's Markdown. It's a lightweight text formatting language that uses simple characters to style your writing.
For example, putting two asterisks (**) around a word makes it bold. Adding a hash symbol (#) in front of a line makes it a heading. It reads almost like plain English, but it turns into a formatted webpage when processed.
You'll recognize Markdown files by their .md extension — like README.md files you see on GitHub. It was created in 2004 as a simpler alternative to HTML, and it's now one of the most widely used formatting languages on the internet.
Why Millions of People Use Markdown Every Day
Writers, developers, bloggers, students, and teachers use Markdown because it's fast, simple, and works everywhere. You don't need special software — any text editor can write it. And it never locks you into a single app or platform.
You'll find Markdown in places like GitHub (where developers write documentation), Discord and Reddit (where users format posts), and note-taking apps like Obsidian and Notion. It's also how many people structure prompts in AI chat tools.
The biggest advantage of Markdown is that your text stays readable even without the formatting applied. In a word processor like Microsoft Word, what you see is only on your computer. Markdown is just plain text — so it works forever, on any device, and never needs a software license.
💡 Key Insight
Markdown files are just plain text — they never go out of date, never need a specific app to open, and can be converted into HTML, PDFs, Word documents, or slideshows whenever you need to share them.
The Core Markdown Symbols to Know
Markdown uses a small set of symbols placed in and around your text to tell the computer how to format it. Here are the most important ones:
# Heading 1 ## Heading 2 ### Heading 3 **bold text** *italic text* [link text](https://example.com) - Bullet list item 1. Numbered list item `inline code` ``` code block ``` > quoted text
Each symbol has a specific meaning. # creates headings — more hashes means a smaller heading. ** makes text bold, * makes it italic. The brackets and parentheses in [text](url) create a clickable link. Once you've written your Markdown, a converter turns it into HTML — the code that web browsers understand.
Markdown in Action: A Simple README
Here's a real example of Markdown being written and what it looks like after it's converted into a formatted webpage:
# My Cool Project A short description of what this project does. ## Features - Fast and simple - Works in any browser - Free to use ## Get Started Clone the repo and run: ``` npm install ```
That plain text, when viewed on GitHub, becomes a nicely formatted project page with a heading, a paragraph, a bulleted list, and a code block. The symbols vanish — only the formatted result remains.
Knowledge Check
Test what you learned with this quick quiz.