Getting Started with Markdown: A Beginner's Guide
Learn the fundamentals of Markdown syntax and start writing formatted documents in minutes. This comprehensive guide covers everything from basic formatting to advanced features.
Jacky
Markdown is one of the most versatile and widely used markup languages in the world. Whether you're writing README files on GitHub, taking notes in Obsidian, or drafting blog posts, Markdown lets you format text quickly without leaving the keyboard.
What You'll Learn
In this guide, we'll cover the essential Markdown syntax that you'll use every day:
- Headings — Structure your document with six levels of headings
- Text formatting — Bold, italic, and strikethrough
- Lists — Ordered and unordered lists
- Links and images — Embedding media
- Code — Inline code and code blocks
- Blockquotes — Quoting text
Your First Markdown Document
Start with something simple. Create a file called hello.md and add:
# Hello, Markdown!
This is my **first** Markdown document.
- Item one
- Item two
- Item three
Most editors and platforms (GitHub, Notion, VS Code) will render this as formatted text automatically.
Headings
Use # symbols to create headings. One # is the largest heading; six ###### is the smallest.
# Heading 1
## Heading 2
### Heading 3
Text Formatting
Make text bold by wrapping it in double asterisks **like this**, or italic with single asterisks *like this*. Combine them for bold italic.
Lists
Create unordered lists with -, *, or +:
- First item
- Second item
- Third item
For ordered lists, just number them:
1. First step
2. Second step
3. Third step
Next Steps
Once you're comfortable with the basics, explore more advanced features:
- Tables for structured data
- Task lists for tracking progress
- Code blocks with syntax highlighting
- Math equations with KaTeX