Markdownチュートリアル

什么是Markdown

Markdown是一种轻量级标记语言,它允许人们使用易读易写的纯文本格式编写文档。

什么是Markdown?

一、Markdown简介

Markdown 是一种轻量级标记语言(Lightweight Markup Language),由 约翰·格鲁伯(John Gruber)2004年 创造(部分语法与亚伦·斯沃茨共同设计)。它的核心目标是:

让人们用易读易写的纯文本格式编写文档,同时能轻松转换为HTML等格式

文件通常以 .md.markdown 为后缀,内容本质是纯文本,但通过简单符号(如 #*[]())实现排版,无需复杂操作。


二、为什么选择Markdown?

1. 核心优势

  • 易读易写:语法直观(例如 **粗体** 直接显示为 粗体),文档即使不渲染也清晰可读。
  • 轻量化:无需臃肿软件,任何文本编辑器(如记事本)均可编辑。
  • 跨平台通用:支持Windows/macOS/Linux/iOS/Android,兼容所有主流编辑器和平台(如GitHub、VS Code、Typora)。
  • 快速转换:可渲染为HTML、PDF、PPT甚至电子书格式(如通过Pandoc工具)。

2. 典型应用场景

  • 📝 技术文档:如GitHub项目中的 README.md 说明文件。
  • 📄 博客/笔记:WordPress、Ghost等博客平台原生支持;常用于Obsidian、Notion等知识管理工具。
  • 📊 数据科学:RStudio等工具中直接编写分析报告,嵌入代码与图表。
  • 🎤 演示文稿:通过工具生成幻灯片(如Marp)。

三、Markdown基础语法示例

1. 标题(层级清晰)

实际效果:

一级标题

二级标题

三级标题

2. 文本格式化

效果语法
加粗**文本**
斜体*文本*
删除线~~文本~~
==高亮====文本==(部分编辑器支持)

3. 列表与链接

  • 无序列表:- 项目* 项目
  • 有序列表:1. 第一项
  • 链接:[显示文字](URL)Google
  • 图片:![替代文字](图片URL)

四、Markdown的进化

  • 标准化努力:因不同平台扩展语法(如表格、任务列表),社区推动统一规范:
    • CommonMark(2014年):解决原始语法的歧义问题,制定严格规范。
    • GitHub Flavored Markdown (GFM)(2017年):在CommonMark基础上增加表格、删除线等实用功能(如GitHub的README支持)。

总结

Markdown用极简的符号实现了高效的排版,平衡了内容专注性格式灵活性。无论是程序员写文档、博主发布文章,还是学生记笔记,它都是提升效率的利器。

🌟 "用文本书写未来,用标记定义格式" —— 这或许就是Markdown的魅力所在。