How to Get Started
How to get started with Markdown
How to Get Started with Markdown?
Step 1: Choose a Markdown Editor
Markdown itself is a plain text format, so you just need an editor that supports Markdown syntax to get started. Here are common choices:
Beginner Recommendations (Simple and Easy):
- Typora (Cross-platform, real-time rendering, clean interface) 👉 Perfect for beginners
- StackEdit (Online editor, no installation required) 👉 Great for temporary use or cloud collaboration
- VS Code + Markdown plugins (Programmer's choice, powerful features)
Advanced Options (Feature-rich):
- Obsidian (Local knowledge management powerhouse, supports bidirectional links and plugins)
- Zettlr (Academic writing friendly, supports references)
- Notion (Supports Markdown syntax input, integrates databases and collaboration)
✅ Recommendation: Beginners can start with Typora or online editors (like StackEdit) to quickly experience Markdown writing and rendering effects.
Step 2: Learn Basic Syntax (5-minute quick start)
The core of Markdown lies in a few simple symbols. Below is a table comparison showing the most commonly used basic syntax to help you quickly understand and remember:
1. Headings (Use # to indicate hierarchy)
| Markdown Syntax | Rendered Effect |
|---|---|
# Level 1 Heading | Level 1 Heading |
## Level 2 Heading | Level 2 Heading |
### Level 3 Heading | Level 3 Heading |
2. Text Styling
| Markdown Syntax | Rendered Effect |
|---|---|
**Bold text** | Bold text |
*Italic text* | Italic text |
~~Strikethrough~~ |
3. Lists
| Markdown Syntax | Rendered Effect |
|---|---|
- Unordered item 1- Unordered item 2 | - Unordered item 1 - Unordered item 2 |
1. Ordered item 12. Ordered item 2 | 1. Ordered item 1 2. Ordered item 2 |
4. Links and Images
| Markdown Syntax | Rendered Effect |
|---|---|
[Display text](https://example.com) | Display text → Google |
 |  → Example:  |
🔗 More syntax can be found at: Markdown Guide (Official Guide)
Step 3: Hands-on Practice
The best way to learn is to learn while writing!
Recommended Practice Methods:
- Create a new
.mdfile (likehello.md) and open it with Notepad or an editor. - Follow the syntax examples in the table above and try modifying content yourself (like writing a level 1 heading, bolding a sentence, inserting a link).
- Use an editor with real-time preview (like Typora) to see effects while writing.
- Upload your Markdown file to GitHub, Notion, or export as PDF/HTML to experience its multi-platform capabilities.
✅ Small Goal: Today, use Markdown to write a diary, take notes, or create a
README.mdfor your project!
Step 4: Integrate into Your Workflow
Based on your needs, Markdown can be naturally integrated into different usage scenarios. Below is a comparison of common scenarios and recommended usage:
| Use Case | Recommended Usage | Common Tools/Platforms |
|---|---|---|
| Blog Writing | Write articles in Markdown, publish via Hexo/Jekyll | Typora / VS Code / Hexo |
| Note Taking | Manage knowledge with note software supporting Markdown input | Obsidian / Notion |
| Code Documentation | Write README.md in projects, clear and professional | GitHub / GitLab / VS Code |
| Daily Recording | Write diaries, plans, checklists | Typora / Obsidian |
| Team Collaboration | Use collaboration platforms supporting Markdown | Notion / Feishu / GitHub |
Summary: How to Get Started with Markdown?
| Step | What to Do | Tool/Method Recommendation |
|---|---|---|
| 1 | Choose an editor | Typora / VS Code / Obsidian |
| 2 | Learn basic syntax (quick reference through tables) | Syntax comparison tables in this article |
| 3 | Write a document by hand (like notes/diary/instructions) | Create your own .md file and practice |
| 4 | Apply to real scenarios | Blog, project docs, knowledge management, collaboration |
🌟 Getting started with Markdown is very simple, but its application scenarios are very broad. Starting today, use a table and a
#symbol to begin your efficient writing journey!