跳到主要内容

Markdown 教程

欢迎学习 Markdown！本教程将带你从零基础开始，全面掌握 Markdown 的核心知识和高级技巧。

什么是 Markdown？​

Markdown 是一种轻量级标记语言，由 John Gruber 于 2004 年创建。它的设计理念是让人们使用易读易写的纯文本格式编写文档，然后转换为结构化的 HTML 或其他格式。

Markdown 的核心特点：

  • 简洁易学：语法简单直观，几分钟就能上手
  • 纯文本格式：任何文本编辑器都能打开和编辑
  • 跨平台兼容：Windows、Mac、Linux 通用
  • 版本控制友好：适合 Git 等版本控制系统管理
  • 可扩展性强：支持 HTML 混写，功能丰富

为什么学习 Markdown？​

1. 行业标准格式​

Markdown 已成为技术文档的标准格式，广泛应用于：

  • GitHub 项目的 README 文件
  • 技术博客和文档网站
  • 开源项目的贡献文档
  • API 文档和用户手册

2. 提升写作效率​

相比 Word 等富文本编辑器，Markdown 让你：

  • 专注于内容而非排版
  • 双手不离开键盘完成所有格式
  • 快速生成结构清晰的文档

3. 团队协作利器​

Markdown 文件：

  • 体积小，便于传输和存储
  • 纯文本格式，便于版本控制
  • 格式统一，避免协作时的样式冲突

4. 多平台支持​

几乎所有主流平台都支持 Markdown：

  • GitHub、GitLab、Bitbucket
  • Notion、Obsidian、Typora
  • VS Code、JetBrains IDE
  • 各种静态网站生成器

Markdown 的版本和规范​

CommonMark​

CommonMark 是 Markdown 的标准化规范，旨在解决原始 Markdown 实现不一致的问题。它定义了明确的解析规则，是目前最广泛支持的 Markdown 标准。

GitHub Flavored Markdown (GFM)​

GFM 是 GitHub 在 CommonMark 基础上的扩展，增加了：

  • 表格语法
  • 任务列表
  • 删除线
  • 自动链接
  • 代码高亮

本教程以 CommonMark 为基础，同时涵盖 GFM 扩展语法。

教程目录​

基础语法​

进阶语法​

高级特性​

实践应用​

学习建议​

  1. 边学边练：每学一个语法点，立即动手实践
  2. 循序渐进：先掌握基础语法，再学习高级特性
  3. 多看多写：阅读优秀的 Markdown 文档，学习其写法
  4. 善用工具：选择合适的编辑器，提高写作效率

参考资源​

准备好开始学习了吗？点击下一章开始你的 Markdown 学习之旅！