No history yet

Introduction to Markdown

What is Markdown?

Markdown is a way to format plain text. Think of it like a set of simple instructions you can add to your writing to make it bold, add a link, or create a list. Instead of clicking buttons in a rich text editor, you just type a few extra characters.

The goal is to make writing for the web feel as easy as writing an email.

Unlike bulky word processors or complex markup languages like HTML, Markdown is designed to be readable as-is. The formatting marks blend in naturally with the text, so you can easily read the raw document without getting distracted by tags and syntax.

Lesson image

A Brief History

Markdown was created in 2004 by John Gruber, with input from Aaron Swartz. They saw a need for a writing format that was easy to write, easy to read, and could be seamlessly converted into HTML for web pages.

The core philosophy of Markdown is to make documents highly readable in plain text while being easily convertible to HTML or other formats.

Before Markdown, if you wanted to format text for the web, you often had to write HTML directly. This meant wrapping your paragraphs in <p> tags and your links in <a> tags. It worked, but it was clunky and made the source text hard to read. Markdown provided a simpler, more elegant solution.

Where You'll Find It

Once you learn to spot it, you'll see Markdown everywhere. It's the standard for writing documentation, especially in the software world. Every project on GitHub, for instance, uses a README.md file to explain what the project does.

Lesson image

It’s also used in many other places:

  • Collaboration tools: Platforms like Slack and Trello use Markdown for formatting messages and comments.
  • Online forums: Websites like Reddit and Discourse use it to let users format their posts.
  • Note-taking apps: Apps like Obsidian, Bear, and Ulysses are built around Markdown for a clean, focused writing experience.
  • Static site generators: Developers use tools like Jekyll and Hugo to write content in Markdown and generate entire blogs and websites from it.

The reason for its popularity is its simplicity. It's a universal language for text that isn't tied to any single company or application. It's just text.

Quiz Questions 1/5

What was the primary goal behind the creation of Markdown?

Quiz Questions 2/5

True or False: The text you write in Markdown is designed to be difficult to read until it is converted into its final, formatted version.

Now that you know what Markdown is and why it was created, you're ready to start learning the basic syntax to format your own documents.