Markdown 笔记：从入门到高效实战的完整指南

说到用 Markdown 做笔记（markdown note taking），很多人的第一反应是"这不就是程序员写代码文档用的吗？"。其实 Markdown 记笔记这件事，门槛比你想的低得多，效率也比你想的高得多。

我最早接触 Markdown 是 2018 年，当时在印象笔记里写技术笔记，格式乱得一塌糊涂。后来切到 Markdown，发现几行简单的符号就能把笔记结构梳理得清清楚楚，再也没回去过。这篇文章把这几年用 Markdown 记笔记的经验整理出来，从基本语法到笔记模板，再到软件选择，一次性讲清楚。

为什么用 Markdown 做笔记

在聊具体怎么用之前，先说说为什么 Markdown 适合记笔记。

格式和内容分离，专注写作本身

用 Word 或富文本编辑器记笔记时，你经常要花时间调字体、调间距、对齐段落。Markdown 用简单的文本符号代替格式按钮——# 是标题，** 是加粗，- 是列表。你只需要关注内容，格式在渲染时自动生成。

纯文本，走到哪都能用

Markdown 文件本质上是纯文本（.md 后缀），不依赖任何特定软件。你在 Obsidian 里写的笔记，用记事本也能打开；换一台电脑，随便找个 Markdown 编辑器就能继续编辑。不用担心"这个软件不兼容那个格式"的问题。

版本管理天然友好

因为 Markdown 是纯文本，配合 Git 做版本管理非常方便。每一次修改都有记录，随时回退到任意版本。对于长期维护的知识库来说，这一点太重要了。

参考：Markdown Guide 指出，Markdown 的设计初衷就是"易读易写的纯文本格式"，这恰好是笔记的核心需求。

Markdown 笔记语法速查

下面这些是用 Markdown 记笔记时最常用的语法，按使用频率排列。如果你想系统地学习每种语法，可以点击对应链接查看详细教程。

标题——笔记的骨架

用 # 号表示标题层级，一级标题一个 #，二级两个，以此类推：

# 会议记录（一级标题）
## 项目进展（二级标题）
### 前端开发（三级标题）

我个人习惯在笔记中最多用到三级标题。层级太深反而会让笔记变得难以浏览。关于标题语法的更多细节，可以参考 Markdown 标题语法详解。

文本强调——划重点

**重要内容用加粗**
*轻微强调用斜体*
~~过时的信息用删除线~~

记笔记时，加粗是最常用的强调方式，我一般用它来标注关键概念和待办事项的核心内容。斜体适合用来标注英文术语或次要强调。想了解更多可以看 Markdown 加粗语法和 Markdown 斜体语法。

列表——整理思路

无序列表用 - 或 *：

- 今天的学习目标
  - 完成 CSS 布局章节
  - 练习 Flexbox 案例
- 明天的计划

有序列表用数字：

1. 第一步：确定笔记主题
2. 第二步：列出关键要点
3. 第三步：补充细节和例子

列表是笔记中最频繁出现的元素，没有之一。想深入了解列表嵌套、缩进等技巧，可以看 Markdown 列表语法详解。

任务列表——待办事项

- [x] 整理本周学习笔记
- [ ] 复习 JavaScript 闭包
- [ ] 写项目周报

这个语法在 GitHub Flavored Markdown（GFM）中支持，大部分笔记软件也支持。打勾的感觉是真的会上瘾。

引用——摘录和批注

> 好记性不如烂笔头，烂笔头不如好方法。

引用块（blockquote）特别适合在笔记中摘录原文或添加自己的批注。在 Markdown 引用语法中有更多用法。

代码块——技术笔记必备

行内代码用反引号：console.log('hello')

代码块用三个反引号：

```javascript
function greet(name) {
  return `Hello, ${name}!`;
}


如果你经常记技术笔记，代码块是使用频率最高的语法之一。详细用法参考 [Markdown 代码块语法](/markdown/code-block/)。

### 链接和图片——关联资源

```markdown
[笔记原文](https://example.com/article)

![截图说明](screenshot.png)

在笔记中引用外部资料或插入截图时，Markdown 链接和 Markdown 图片语法非常方便。

表格——结构化信息

| 软件 | 平台 | 价格 | Markdown 支持 |
|------|------|------|--------------|
| Obsidian | 全平台 | 免费 | 原生支持 |
| 有道云笔记 | 全平台 | 免费/会员 | 支持 |
| 印象笔记 | 全平台 | 免费/付费 | 支持 |

更多表格技巧（对齐方式、复杂表格）可以看 Markdown 表格语法详解。

分割线——内容分隔

---

上面的内容讲完了，下面开始新的话题。

三个短横线就是一条分割线，用来区分笔记的不同部分。

Markdown 笔记模板（拿来就用）

说实话，模板这东西每个人的习惯不一样，但有几个通用模板我用了好几年，分享出来你可以直接复制改改用。

模板一：会议记录

# 会议记录：{项目名称}周例会

**日期：** 2026-05-04
**参会人：** 张三、李四、王五
**记录人：** 我

## 议题

### 1. 上周进展

- 前端页面完成 80%，剩余表单验证部分
- 后端接口已全部联调通过

### 2. 本周计划

- [ ] 完成表单验证和错误提示
- [ ] 移动端适配
- [ ] 性能优化——首屏加载时间目标 < 2s

### 3. 待确认事项

- 设计稿中弹窗样式需要和 UI 确认
- 第三方支付接口文档还没收到

## 下次会议

**时间：** 2026-05-11 10:00
**议题：** Sprint 回顾 + 下阶段规划

模板二：学习笔记

# {课程/书籍名称}学习笔记

**标签：** #前端 #CSS
**日期：** 2026-05-04

## 核心概念

**Flexbox** 是一种一维布局模型，可以沿着主轴或交叉轴排列元素。

### 关键属性

| 属性 | 作用 | 常用值 |
|------|------|--------|
| display | 启用弹性布局 | flex |
| flex-direction | 主轴方向 | row, column |
| justify-content | 主轴对齐 | center, space-between |
| align-items | 交叉轴对齐 | center, stretch |

## 我的理解

Flexbox 解决的核心问题是：让容器中的元素能够灵活地分配空间和对齐。以前用 float 布局需要各种清除浮动、计算宽度，现在几行 CSS 就搞定。

## 实践练习

```css
.container {
  display: flex;
  justify-content: space-between;
  align-items: center;
}

疑问与待查

[ ] flex-basis 和 width 的优先级关系是什么？
[ ] 嵌套 flex 容器的性能影响有多大？

参考资料

MDN Flexbox 指南

模板三：技术方案笔记

# 技术方案：{功能名称}

**作者：** 我
**日期：** 2026-05-04
**状态：** 草案

## 背景

当前系统在处理大批量数据导出时，接口响应时间超过 30 秒，用户频繁超时。

## 方案对比

| 方案 | 优点 | 缺点 | 复杂度 |
|------|------|------|--------|
| 异步导出 + 邮件通知 | 用户体验好 | 需要消息队列 | 中 |
| 分页加载 + 前端缓存 | 实现简单 | 数据量大时卡顿 | 低 |
| WebSocket 推送进度 | 实时反馈 | 需要长连接 | 高 |

## 最终方案

采用异步导出方案，具体实现：

1. 前端发起导出请求，后端返回任务 ID
2. 后端将任务放入队列，异步处理
3. 处理完成后发送邮件通知，附带下载链接

## 注意事项

- 单次导出上限设为 10 万条
- 文件保留 7 天后自动清理
- 失败重试最多 3 次

模板四：日常待办

# 今日待办 — 2026-05-04

## 紧急且重要

- [ ] 修复线上支付回调超时问题
- [ ] 回复客户的技术咨询邮件

## 重要不紧急

- [ ] 整理上周的技术分享 PPT
- [ ] 学习 Docker Compose 基础

## 杂项

- [ ] 预约周五的会议室
- [ ] 更新项目文档中的接口说明

## 今日总结

完成了支付回调问题的排查，根因是第三方接口超时时间设置过短（5s），调整为 15s 后解决。这个经验值得记录：**对接第三方接口时，超时设置要留足余量。**

Markdown 笔记软件推荐

选对工具，用 Markdown 记笔记的体验会好很多。下面是我实际用过的一些软件，按场景分类。

主流 Markdown 笔记软件对比

软件	平台	价格	核心特点	适合谁
Obsidian	Win/Mac/Linux/移动端	免费（同步付费）	本地存储、双向链接、插件生态丰富	知识管理重度用户
有道云笔记	Win/Mac/移动端	免费/会员	国内老牌、云端同步、支持 Markdown	国内用户、轻量需求
印象笔记	Win/Mac/移动端	免费/付费	网页剪藏强、多端同步	信息收集型用户
Notion	Web/Win/Mac/移动端	免费/付费	数据库功能强、协作方便	团队协作、项目管理
VS Code	Win/Mac/Linux	免费	插件丰富、终端集成	程序员、技术笔记
Bear	Mac/iOS	免费/订阅	界面美观、标签管理	苹果生态用户

数据来源：各软件官方网站，2026 年 5 月查询。价格可能随时间变化，请以官网为准。

我的选择建议

如果你是刚开始用 Markdown 记笔记，我的建议是先用有道云笔记或印象笔记，门槛低，打开就能写。等你觉得"我想更多控制权和定制空间"的时候，再考虑切换到 Obsidian。

如果你是程序员，VS Code 装个 Markdown 预览插件（推荐 Markdown Preview Enhanced）就够了，反正你每天都在用，不用额外装软件。

Markdown 笔记的进阶技巧

掌握基本语法之后，这些技巧能让你的笔记质量再上一个台阶。

用标签系统组织笔记

在笔记开头加上标签，方便后续检索：

---
tags: [前端, CSS, 布局]
date: 2026-05-04
---

# Flexbox 学习笔记
...

这种写法叫做 front matter，Obsidian、Hugo 等工具都能自动识别。很多笔记软件会根据这些标签自动归类。

用脚注添加参考资料

写学习笔记时，脚注比直接塞链接更整洁：

CSS Grid 是二维布局系统[^1]，和 Flexbox 的一维布局互补[^2]。

[^1]: MDN CSS Grid 指南: https://developer.mozilla.org/zh-CN/docs/Web/CSS/CSS_grid_layout
[^2]: CSS-Tricks Flexbox 指南: https://css-tricks.com/snippets/css/a-guide-to-flexbox/

脚注的详细语法可以参考 Markdown 脚注教程。

数学公式——学术笔记利器

如果你的笔记涉及数学（比如统计、物理、经济学），大部分 Markdown 笔记软件都支持 LaTeX 公式：

行内公式：$E = mc^2$

块级公式：
$$
\sum_{i=1}^{n} x_i = x_1 + x_2 + \cdots + x_n
$$

这在有道云笔记、Obsidian、VS Code 中都能正常渲染。更多语法细节参考 Markdown 数学公式教程。

Mermaid 图表——一张图胜千言

有些笔记用文字描述很啰嗦，画个流程图就清楚了。Mermaid 语法可以直接在 Markdown 中嵌入图表：

```mermaid
graph TD
    A[开始] --> B{是否理解？}
    B -->|是| C[记入笔记]
    B -->|否| D[查资料]
    D --> E[理解后记入笔记]
    E --> C
    C --> F[定期复习]



Obsidian、GitHub、有道云笔记都支持 Mermaid 渲染。

## 避开这些常见问题

用 Markdown 记笔记的路上有几个小坑，提前知道能省不少时间。

### 换行不是按回车

在 Markdown 中，单独一个回车不会产生新段落。你需要**在行末加两个空格**再回车，或者**空一行**来分段。这个细节坑了我很久，后来养成了空行分段的习惯就好了。详细说明看 [Markdown 换行语法](/markdown/new-line/)。

### 特殊字符需要转义

如果你的笔记内容中包含 `*`、`_`、`#` 这些 Markdown 语法符号，但不想它们被解析为格式，用反斜杠转义：`\*这不是斜体\*`。更多转义规则参考 [Markdown 转义字符](/markdown/escape/)。

### 不同软件的语法差异

我遇到过一个让人头疼的事：同一篇笔记在 Obsidian 里渲染正常，换到 GitHub 上就出问题。原因是不同 Markdown 解析器对语法的支持不完全一致。常见的差异有：

| 语法元素 | 标准 Markdown | GFM (GitHub) | Obsidian |
|----------|--------------|--------------|----------|
| 任务列表 | 不支持 | 支持 | 支持 |
| 脚注 | 不支持 | 支持 | 支持 |
| 数学公式 | 不支持 | 不支持 | 支持 |
| 双向链接 | 不支持 | 不支持 | 支持 |
| 表格 | 不支持 | 支持 | 支持 |

> 数据来源：[Markdown Guide](https://www.markdownguide.org/extended-syntax/) 和各工具官方文档，2026 年 5 月整理。

所以我的习惯是：**如果你主要在一个软件里用，就按那个软件的语法来。如果需要跨平台，尽量只用标准 Markdown 语法**（标题、列表、加粗、链接、代码块）。

## 我的 Markdown 笔记习惯

分享几个我坚持了多年的小习惯，确实有效：

**一是每篇笔记都写日期。** 放在标题或开头，方便日后按时间线回顾。我用的格式是 `YYYY-MM-DD`，排序天然有序。

**二是标题层级不超过三级。** `#` 是笔记标题，`##` 是大板块，`###` 是具体内容。再深了就说明这篇笔记应该拆成几篇。

**三是定期整理。** 每周末花 20 分钟，把本周的零散笔记归档到对应的主题文件夹里。不整理的笔记和没记一样。

**四是善用搜索。** 笔记多了之后，与其花时间设计复杂的目录结构，不如依赖全文搜索。Markdown 是纯文本，搜索速度极快，一个关键词就能找到相关内容。

## 小结

Markdown 记笔记这件事，说到底就三步：学会几个常用符号、找个顺手的软件、养成持续记录的习惯。语法本身没几行，但用好它记笔记的效率提升是实打实的。

如果你还没开始，打开任何一个文本编辑器，复制上面的模板，从今天的笔记开始写吧。

---

**参考资料：**

- [Markdown Guide — Basic Syntax](https://www.markdownguide.org/basic-syntax/)：最权威的 Markdown 语法参考
- [GitHub Docs — Basic Writing and Formatting Syntax](https://docs.github.com/en/get-started/writing-on-github/getting-started-with-writing-and-formatting-on-github/basic-writing-and-formatting-syntax)：GitHub 官方 Markdown 文档

Edward Wang