What is Markdown? A Beginner's Guide

If you have ever written a README on GitHub, formatted a Reddit post, or used a note-taking app like Obsidian, you have already used Markdown. It is a lightweight way to format text using simple symbols instead of clicking toolbar buttons or writing HTML tags.

Markdown is a plain-text formatting language created by John Gruber in 2004. The idea is simple: write text with a few special characters to indicate formatting, and any Markdown-compatible tool will render it as a nicely formatted document. The raw text stays readable even without rendering, which is one of its biggest advantages.

Here are the most common Markdown formatting rules:

• Headings - Use # for h1, ## for h2, ### for h3, and so on
• Bold - Wrap text with **double asterisks**
• Italic - Wrap text with *single asterisks*
• Links - Use [link text](url) format
• Images - Use ![alt text](image-url) format
• Lists - Use - or * for bullet points, 1. for numbered lists
• Code - Use backticks for `inline code` or triple backticks for code blocks
• Blockquotes - Start a line with >

Markdown has been widely adopted across the tech industry and beyond. Here are some of the most popular platforms that support it:

• Simple to Learn - Basic syntax takes minutes to pick up
• Portable - Plain text works everywhere, on every operating system
• Version Control Friendly - Works perfectly with Git for tracking changes
• Future-Proof - Plain text files will always be readable, unlike proprietary formats
• Converts to Anything - Markdown can be converted to HTML, PDF, DOCX, and many other formats