Markdown 教程

AI 时代的文本写作利器

小白也能五分钟上手的工具

从一个北大法学教授的故事说起...

一位北大法学教授开了门法律写作课,要求用 Markdown 格式提交作业。

令他诧异的是,第二次课少了一半学生 —— 他们因害怕这个陌生的"Markdown"而退课了!

有时候,我们最大的敌人不是困难本身,而是对未知的恐惧。
Markdown概念示意

今天,就让我带着你一起,揭开 Markdown 的神秘面纱,看看它究竟有多简单!又能给你的数字生活带来多大改变!

Markdown 是从哪来的?

Markdown 由两位技术天才在 2004 年创造

John Gruber

  • 著名科技博主和程序员
  • 创建了知名博客 Daring Fireball
  • 创造初衷:既容易阅读,又容易写作的纯文本格式

Aaron Swartz

  • 互联网活动家和编程神童
  • 14岁参与创建RSS规范
  • Reddit联合创始人
  • 2013年逝世,享年26岁

名字的由来

名字来源于 Mark"up"(标记)的反义词 Mark"down"

暗示这种写法比传统标记语言简单多了

Markup to Markdown

Markdown 能解决什么问题?

传统文档的烦恼

  • Word 太复杂
  • 格式不统一
  • 文件太大
  • 平台不兼容
  • 版本控制困难
  • 注意力分散

Markdown 的解决方案

  • 超级简单:几个符号搞定格式
  • 纯文本万岁:文件小,通用性强
  • 内容为王:专注写作,不调格式
  • 随处可用:手机、电脑、平板全兼容
  • 版本控制友好:Git等工具可精确跟踪
  • 统一体验:格式一致

为什么现在大家都在用 Markdown?

现在是 AI 时代,Markdown 变得更火了,原因如下:

AI 喜欢结构化

ChatGPT/Claude这样的AI工具很喜欢Markdown格式的输入输出

笔记软件崛起

Obsidian、Notion、Logseq这些热门笔记软件都支持Markdown

程序员带头用

GitHub、Stack Overflow等技术网站都用Markdown

简单高效

信息爆炸时代,我们需要快速记录和整理知识

Markdown 基本写法大全

接下来,我们学习最常用的Markdown语法

标题(就像报纸的大字标题)

# 这是一级标题(超大)
## 这是二级标题(大)
### 这是三级标题(中等)
#### 这是四级标题(小)
##### 这是五级标题(更小)
###### 这是六级标题(最小)

记住:井号后面要空一格,不然不生效!

Markdown标题示例

强调文字(让文字更显眼)

*这样写就是斜体*
**这样写就是粗体**
***这样写就是粗斜体***
~~这样写就是删除线~~

效果如下:

这样写就是斜体

这样写就是粗体

这样写就是粗斜体

这样写就是删除线

列表(购物清单一样的东西)

无序列表

- 苹果
- 香蕉
  - 小香蕉
  - 大香蕉
- 橙子

有序列表

1. 第一步
2. 第二步
3. 第三步

无序列表效果:

  • 苹果
  • 香蕉
    • 小香蕉
    • 大香蕉
  • 橙子

有序列表效果:

  1. 第一步
  2. 第二步
  3. 第三步

链接与图片

链接(点击跳转的网址)

[点我去B站](https://bilibili.com/)

效果:点我去B站

图片(在文章中插入图片)

![这是图片说明](https://example.com/image.jpg)
Markdown图片示例

图片预览效果

引用与代码

引用(引用别人说的话)

> 这是一句名人名言。
> 
> 这是第二段引用。

行内代码

我们可以用 `print("你好")` 来打印输出"你好"。

效果如下:

这是一句名人名言。

这是第二段引用。

行内代码效果:

我们可以用 print("你好") 来打印输出"你好"。

代码块效果:

def hello():
    print("你好,世界!")
hello()

表格(展示行列数据)

| 姓名 | 年龄 | 爱好 |
| --- | --- | --- |
| 大壮 | 18 | 篮球 |
| 小美 | 17 | 唱歌 |

效果如下:

姓名 年龄 爱好
大壮 18 篮球
小美 17 唱歌

提示:表格第二行的破折号数量不重要,但每列至少要有一个

GitHub 特别版 Markdown

GitHub是程序员最爱的网站,它给Markdown加了一些特别好用的功能:

任务清单
- [x] 已完成的任务
- [ ] 未完成的任务
- [ ] 另一个未完成的任务

效果:

  • 已完成的任务
  • 未完成的任务
  • 另一个未完成的任务
表情符号
我很开心 :smile: 
我爱编程 :heart: 
点赞 :thumbsup:

效果:

我很开心 😁 我爱编程 ❤️ 点赞 👍

GitHub还会自动识别网址和用户提及(@用户名),非常方便协作和引用

零基础如何快速学会 Markdown

回到开头我的法学教授朋友分享的故事,如果他的学生们知道学Markdown这么简单,应该就不会退课了吧。

快速掌握Markdown的方法:

  1. 找个软件开始练:下载一个支持Markdown的软件
  2. 从最简单的开始:先学会写标题和列表就够日常使用了
  3. 边写边看效果:大多数Markdown编辑器都有预览功能
  4. 实际项目中用:尝试用Markdown写日记、笔记或工作文档
  5. 不求全会,常用就好:掌握20%的语法就能应付80%的场景

小提示

如果你只记住一种Markdown语法,就记住如何创建标题(# 加空格)。

仅这一个技巧就能让你的文档结构清晰许多!

8 款最好用的 Markdown 软件

选择一款好用的Markdown编辑器能大幅提升写作体验

Typora (所有电脑都能用)

  • 为什么好用:所见即所得,你写的同时就能看到效果
  • 多少钱:15天免费试用,之后单用户授权约$14.99
  • 适合谁用:喜欢简洁、不想看代码的人
Typora界面示意图

VS Code (所有电脑都能用)

  • 为什么好用:免费!还能装很多插件增强功能
  • 多少钱:完全免费
  • 适合谁用:程序员或者不怕复杂界面的人

网址https://visualstudio.microsoft.com/zh-hans/

推荐插件:Markdown All in One 或 Markdown Preview Enhanced

VS Code界面示意图

Obsidian (所有电脑都能用)

  • 为什么好用:不只是编辑器,还是强大的笔记系统
  • 多少钱:个人使用免费,商业使用需付费
  • 适合谁用:想建立知识库、做学习笔记的人
Obsidian界面示意图

更多优秀的Markdown编辑器

飞书文档

团队协作神器,支持多人实时编辑

免费基础功能 中国出品

MarkText

开源免费,界面简洁,实时预览

完全免费 开源

MWeb

专为中文用户设计,发布到各平台方便

付费 苹果专用

超实用在线 Markdown 工具

不想安装软件?试试这些优秀的在线编辑器

Doocs Markdown 编辑器

  • 支持多种主题,导出PDF、图片
  • 临时编辑,分享美观的文档
  • 开源项目,可以自己部署

网址https://md.doocs.org/

乔木 Markdown 编辑器

  • 简洁界面,AI辅助功能
  • 快速编辑和分享内容
  • 基于Doocs搭建的自用工具

网址https://md.qiaomu.ai/

使用在线工具时,记得定期保存你的内容到本地,避免数据丢失!

把 Markdown 变成其他格式

Markdown最棒的地方是可以轻松变成其他格式

Pandoc:终极格式转换神器

Pandoc是一个超强大的免费文档转换工具,几乎可以在任何文档格式之间转换。

常用命令

# Markdown转Word
pandoc -s 文件名.md -o 文件名.docx

# Markdown转PDF
pandoc 文件名.md -o 文件名.pdf

# Markdown转HTML
pandoc -s 文件名.md -o 文件名.html

# Markdown转PPT幻灯片
pandoc -t revealjs -s 文件名.md -o 文件名.html

安装方法

Windows:下载并运行官网的安装程序(.msi文件)

Mac:打开终端,输入

brew install pandoc

大多数Markdown编辑器也自带导出功能,可以直接转换为PDF、HTML等格式。

Markdown 有什么不足?怎么解决?

不足之处

  • 不能做复杂排版:不像Word那样能精确控制每个元素的位置
  • 图片处理能力弱:不能直接调整图片大小、位置
  • 表格功能简单:不支持合并单元格等高级表格功能
  • 数学公式:基础Markdown不支持数学公式
  • 不同平台显示差异:有些特殊语法在不同软件里效果不同

解决方案

  • 需要精美排版的文档,最后阶段可以转为Word再调整
  • 可以用HTML标签来控制图片,比如:
    <img src="图片.jpg" width="300">
  • 复杂表格可以用HTML表格代码
  • 使用支持LaTeX的Markdown编辑器处理数学公式
  • 尽量使用基础语法,避免使用特殊功能

Markdown 进阶技巧

掌握了基础后,这些进阶技巧会让你的Markdown使用更上一层楼

内嵌 HTML & 脚注

内嵌HTML

<div style="text-align: center; color: red;">
  这是居中的红色文字
</div>

<details>
  <summary>点击展开更多内容</summary>
  这里是隐藏的详细内容...
</details>

脚注

这里有一个脚注[^1]。

[^1]: 这是脚注的内容。

效果:

这里有一个脚注1


1: 这是脚注的内容。

Mermaid 图表

许多现代Markdown编辑器支持Mermaid语法,可以创建流程图、时序图等:

```mermaid
graph TD;
    A[开始] -->|输入数据| B(处理)
    B --> C{判断}
    C -->|是| D[输出结果]
    C -->|否| E[错误处理]
    E --> B
    D --> F[结束]
```
Mermaid流程图示例

Mermaid还可以绘制时序图、甘特图、类图和状态图等多种图表

其他进阶技巧

定义列表
苹果
: 一种红色或绿色的水果
: 一家科技公司

香蕉
: 一种黄色的水果
目录自动生成
[TOC]

或者

[[TOC]]

很多编辑器支持自动目录生成

键盘按键显示
按下 <kbd>Ctrl</kbd>+<kbd>C</kbd> 复制文本

效果:按下 Ctrl+C 复制文本

Markdown 与 AI 的完美结合

AI时代,Markdown和AI工具组合,能创造全新工作流程

ChatGPT 与 Markdown 的默契配合

ChatGPT原生支持Markdown格式,这意味着:

  • 格式化输出:要求ChatGPT用Markdown格式输出内容
  • 结构化提示:用Markdown格式编写提示词
  • 表格生成:快速生成复杂的Markdown表格

实用提示:使用"输出为Markdown Code",方便复制

实用提示模板

请用Markdown格式帮我创建一篇关于[主题]的文章,包含以下部分:
1. 引言
2. 主要内容(至少3个小节)
3. 总结

使用适当的标题层级、列表和强调,确保格式美观。

Obsidian + AI 插件:知识管理的革命

Obsidian是基于Markdown的知识管理工具,结合AI插件后功能更强大:

Smart Composer 插件

类似Cursor的AI辅助写作功能,直接在Markdown文件中获得智能补全

Copilot 插件

在笔记中直接与各种AI模型对话,生成内容并插入当前笔记

Text Generator 插件

一键生成各种类型的内容,支持自定义Prompt和模型

知识库与AI结合:支持Embedding后与整个笔记库对话,推荐相关内容

创建智能 Markdown 模板

结合AI和Markdown创建智能模板,提高工作效率:

---
title: {{title}}
date: {{date}}
tags: {{tags}}
---

# {{title}}

## 背景

[AI 在这里根据标题自动生成背景内容]

## 主要内容

[AI 在这里生成主要内容的大纲]

## 行动项目

- [ ] 第一个待办事项
- [ ] 第二个待办事项

## 参考资料

[AI 自动搜索并提供相关参考资料]

这种模板可以与Obsidian的模板插件结合,打造强大的知识管理系统

不同行业的 Markdown 应用案例

法律行业
  • 法律文档标准化
  • 案例研究
  • 协作审阅
  • 法律教育
"自从我们律所采用Markdown后,合同审阅效率提高了40%,因为我们可以专注于内容而非格式。"
学术研究
  • 研究笔记
  • 论文写作
  • 文献管理
  • 开放科学
内容创作
  • 博客文章
  • 电子书
  • 内容管理
  • 多平台发布
软件开发
  • 项目文档
  • 技术文档
  • 问题跟踪
  • 代码评审

未来趋势:Markdown 将如何演变?

AI 增强的 Markdown 编辑器

  • 实时建议:AI提供写作建议和格式优化
  • 自动生成:根据简短描述生成完整段落
  • 内容丰富:自动添加相关图片、链接和参考资料
  • 语义理解:基于内容自动组织文档结构

跨平台知识图谱

  • 语义链接:不仅链接文档,还链接概念和想法
  • 动态更新:内容自动与最新信息同步
  • 协作网络:多人共同构建和维护知识库
  • 可视化导航:通过图形界面探索知识连接

Markdown不仅是一种写作格式,更是连接人类思维和人工智能的桥梁。掌握Markdown,就等于为自己的数字生活打下了坚实的基础。

总结:为什么你应该现在就开始用 Markdown?

回到开头那个法学教授的故事,那些退课的学生错过了什么?他们错过了一个能够彻底改变数字写作和知识管理方式的工具。

Markdown不仅仅是一种格式,它是一种思维方式,一种让你专注于内容而非形式的哲学。

在信息过载的时代,这种简洁性变得尤为珍贵。

Markdown的核心优势

  • 超级容易学:10分钟就能学会基础用法
  • 提高效率:不用再为调整格式浪费时间
  • 文件小巧:纯文本文件,几十KB就能存储长文章
  • 兼容性好:在任何设备上都能查看和编辑
  • 未来趋势:越来越多的平台和工具支持Markdown
  • 与AI工具完美配合:现代AI工具都支持Markdown格式

立即行动:现在就打开一个Markdown编辑器,试着写下:# 我的第一篇 Markdown 文章

恭喜你!你已经开始使用Markdown了!🎉

小彩蛋:Markdown 创始人的名言

"The overriding design goal for Markdown's formatting syntax is to make it as readable as possible. The idea is that a Markdown-formatted document should be publishable as-is, as plain text, without looking like it's been marked up with tags or formatting instructions."
— John Gruber,Markdown创始人

翻译:Markdown格式语法的首要设计目标是使其尽可能易于阅读。其理念是Markdown格式的文档应该可以直接发布,作为纯文本,而不会看起来像是用标签或格式指令标记过的。

"Information is power. But like all power, there are those who want to keep it for themselves."
— Aaron Swartz,Markdown共同创造者

翻译:信息就是力量。但就像所有的力量一样,总有人想要独占它。

感谢聆听!