Markdown Learning Resources

Learning Markdown is a gradual journey. This chapter collects various high-quality learning resources to help you go from beginner to advanced. These resources include official documentation, tutorials, tools, and communities.

Official Resources

Markdown Official Website

• Official Site: https://daringfireball.net/projects/markdown/
• Description: The original Markdown website created by John Gruber contains complete syntax documentation and examples
• Best For: Understanding the origins and basic syntax of Markdown

CommonMark Specification

• Official Site: https://commonmark.org/
• Description: Standardized Markdown specification that resolves ambiguities in original Markdown
• Best For: Deep diving into Markdown specifications

Online Tutorials

English Tutorials

Markdown Guide

• URL: https://www.markdownguide.org/
• Features: Comprehensive Markdown guide including cheat sheets and extended features
• Best For: From beginner to advanced

Learn Markdown in 60 Seconds

• URL: https://commonmark.org/help/
• Features: Quick 60-second introduction
• Best For: Quick start

GitHub Flavored Markdown Spec

• URL: https://github.github.com/gfm/
• Features: Markdown extension specification used by GitHub
• Best For: GitHub users

Editors and Tools

Desktop Editors

Typora

• Website: https://typora.io/
• Platform: Windows, macOS, Linux
• Features:
  • WYSIWYG
  • Real-time preview
  • Supports math formulas and diagrams
  • Supports exporting to multiple formats
• Price: Paid (one-time purchase)
• Rating: ⭐⭐⭐⭐

Obsidian

• Website: https://obsidian.md/
• Platform: Windows, macOS, Linux, iOS, Android
• Features:
  • Bidirectional linking
  • Knowledge graph
  • Rich plugin ecosystem
  • Local storage
• Price: Free to use, paid sync service
• Rating: ⭐⭐⭐⭐

VS Code + Markdown Plugins

• Recommended Plugins: Markdown Preview Enhanced
• Platform: Windows, macOS, Linux
• Features:
  • Free
  • Highly extensible
  • Integrated development environment
  • Supports multiple renderers
• Price: Free
• Rating: ⭐⭐⭐

MarkText

• Website: https://marktext.app/
• Platform: Windows, macOS, Linux
• Features:
  • Open-source and free
  • Clean interface
  • Real-time preview
  • Supports Mermaid diagrams
• Price: Free
• Rating: ⭐⭐⭐

Online Editors

StackEdit

• URL: https://stackedit.io/
• Features:
  • Online editing
  • Auto-save to cloud
  • Supports publishing to blogs
  • Real-time collaboration
• Price: Free
• Rating: ⭐⭐⭐⭐

Dillinger

• URL: https://dillinger.io/
• Features:
  • Simple online editor
  • Supports import/export
  • Supports multiple publishing platforms
• Price: Free
• Rating: ⭐⭐⭐

Markdown Live Preview

• URL: https://markdownlivepreview.com/
• Features:
  • Simple and fast
  • Real-time preview
  • Supports sidebar
• Price: Free
• Rating: ⭐⭐⭐

Mobile Editors

MWeb

• Platform: iOS, macOS
• Features:
  • Powerful editing features
  • Supports image hosting
  • Supports multiple blog platforms
• Price: Paid
• Rating: ⭐⭐⭐⭐

Text Editor (iOS/Android)

• Platform: iOS, Android
• Features:
  • Cross-platform sync
  • Simple and easy to use
• Price: Free
• Rating: ⭐⭐⭐⭐

Static Site Generators

Jekyll

• Website: https://jekyllrb.com/
• Features:
  • Native support from GitHub Pages
  • Ruby-based
  • Rich plugin ecosystem
• Best For: GitHub blogs

Hugo

• Website: https://gohugo.io/
• Features:
  • Fast build speed
  • Go language development
  • Flexible configuration
• Best For: Large sites

Hexo

• Website: https://hexo.io/
• Features:
  • Node.js development
  • Rich themes
  • Complete plugin system
• Best For: Personal blogs

VitePress

• Website: https://vitepress.dev/
• Features:
  • Based on Vue
  • Extremely fast builds
  • Suitable for technical documentation
• Best For: Documentation sites

Docusaurus

• Website: https://docusaurus.io/
• Features:
  • Developed by Facebook
  • Supports React components
  • Suitable for documentation and blogs
• Best For: Technical documentation

Diagramming Tools

Mermaid

• Website: https://mermaid.js.org/
• Features: Flowcharts, sequence diagrams, Gantt charts, etc.
• Online Editor: https://mermaid.live/

PlantUML

• Website: https://plantuml.com/
• Features: UML diagrams
• Online Editor: http://www.plantuml.com/plantuml/

Draw.io (diagrams.net)

• Website: https://www.diagrams.net/
• Features: General-purpose diagramming tool
• Supports: Exporting to Markdown format

Note-taking and Knowledge Management

Notion

• Website: https://www.notion.so/
• Features: Full-featured note app with Markdown support
• Platform: Web, desktop, mobile

Evernote

• Website: https://evernote.com/
• Features: Established note app with Markdown support
• Platform: All platforms

OneNote

• Website: https://www.onenote.com/
• Features: Microsoft note app with Markdown plugins
• Platform: All platforms

Math Formula Tools

MathJax

• Website: https://www.mathjax.org/
• Features: Web math formula rendering

KaTeX

• Website: https://katex.org/
• Features: Fast math formula rendering library

LaTeX Cheat Sheet

• URL: https://wmd-editor.com/images/math.gif
• Features: LaTeX math symbol cheat sheet

Image Hosting Services

Qiniu Cloud

• Website: https://www.qiniu.com/
• Features: Stable in China, fast speed

Alibaba Cloud OSS

• Website: https://www.aliyun.com/product/oss
• Features: Stable and reliable, reasonable pricing

Cloudinary

• Website: https://cloudinary.com/
• Features: Global CDN, auto-optimization

Imgur

• Website: https://imgur.com/
• Features: Free image hosting, simple to use

Communities and Forums

GitHub

• Discussions: https://github.com/github/feedback/discussions
• Features: Markdown-related discussions
• Language: Primarily English

Stack Overflow

• Tag: markdown
• URL: https://stackoverflow.com/questions/tagged/markdown
• Features: Q&A

Reddit

• Community: r/markdown
• URL: https://www.reddit.com/r/markdown/
• Features: Discussions and sharing

Video Tutorials

YouTube

Recommended Channels:

• Traversy Media
• Net Ninja
• FreeCodeCamp

Book Recommendations

English Books

1. Markdown: Up and Running

   • Author: Trevor Burnham
   • Description: Comprehensive Markdown guide

2. Pro Git

   • Authors: Scott Chacon, Ben Straub
   • Description: Although primarily about Git, includes GitHub Pages and Markdown content

Cheat Sheets

Markdown Cheat Sheet

• PDF Version: https://www.markdownguide.org/cheat-sheet/
• Multiple Versions: Various online versions

Mermaid Cheat Sheet

• Official Site: https://mermaid.js.org/intro/

LaTeX Math Formula Cheat Sheet

• Online Tool: https://wmd-editor.com/images/math.gif

Plugins and Extensions

Browser Extensions

• Markdown Viewer

  • Chrome/Edge extension
  • View Markdown files in browser

• Markdown Here

  • Use Markdown in email editors

VS Code Extensions

• Markdown Preview Enhanced

  • Most powerful Markdown preview plugin

• Markdown All in One

  • Full-featured Markdown editing support

• Paste Image

  • Convenient image pasting

Learning Path Recommendations

Beginners (Weeks 1-2)

1. Read official documentation to understand basic syntax
2. Use online editors for practice
3. Complete simple document writing
4. Recommended resources:
   • Markdown Guide
   • CommonMark help

Intermediate Learning (Weeks 3-4)

1. Learn GFM extended syntax
2. Master tables and math formulas
3. Learn diagramming
4. Recommended resources:
   • GitHub Flavored Markdown
   • Mermaid documentation

Practical Application (Weeks 5-6)

1. Write complete documents using Markdown
2. Build a personal blog
3. Use tools to automate workflows
4. Recommended resources:
   • Jekyll/Hugo documentation
   • Static blog setup tutorials

Deep Mastery (Week 7+)

1. Explore advanced features and customization
2. Participate in community discussions
3. Share experiences and tutorials
4. Recommended resources:
   • GitHub community
   • Stack Overflow

Practice Project Suggestions

Entry-level Projects

1. Personal Resume

   • Write resume in Markdown
   • Export to PDF

2. Study Notes

   • Record study notes with Markdown
   • Organize knowledge structure

Intermediate Projects

1. Technical Blog

   • Use static site generator
   • Deploy to GitHub Pages

2. API Documentation

   • Write API documentation for projects
   • Use tables and code blocks

Advanced Projects

1. E-book

   • Write using Markdown
   • Convert to PDF or EPUB

2. Technical Tutorial

   • Write complete tutorial series
   • Include diagrams and math formulas

Common Question Resources

GitHub Issues

• Check relevant project Issues
• Learn from others' solutions

Stack Overflow

• Search for specific questions
• Refer to best practices

Official Documentation

• Consult tool official documentation
• Understand complete tool features

Updates and News

Follow these channels for latest information

• Blogs: Follow official blogs of relevant tools
• Twitter: Follow #Markdown hashtag
• GitHub: Watch relevant repositories
• Reddit: Subscribe to r/markdown

Summary

Learning Markdown is an ongoing process. Here are some suggestions:

Learning Tips

1. Learn and Practice: Practice immediately after learning syntax
2. From Simple to Complex: Master basics first, then learn advanced features
3. Use Tools: Choose appropriate editors to improve efficiency
4. Read Source Code: Review source code of excellent Markdown documents
5. Participate in Community: Join discussions and share experiences

Tool Selection Recommendations

• Daily Writing: Typora or Obsidian
• Development Environment: VS Code + plugins
• Quick Editing: Online editors
• Mobile Editing: MWeb or Text Editor

Continuous Learning

Markdown is constantly evolving, with new tools and techniques continuously emerging. Maintain enthusiasm for learning, actively participate in the community, and you'll discover the power and charm of Markdown.

Wishing you a fruitful Markdown learning journey! 🎉

---

Related Links

• Return to Tutorial Home
• Markdown Introduction
• Markdown Basic Syntax

Thank you for reading this Markdown tutorial!