零基础学 Markdown：我做技术笔记和博客文档的真实学习笔记与踩坑实录

为什么我最终选了 Markdown 做笔记

刚开始记技术笔记，我是在 Word 和各种富文本编辑器之间来回切换，结果格式越改越乱，代码块还经常串行，复制粘贴一段命令就全塌了。后来接触到 Markdown，才发现它用纯文本就能写出带层级、带代码、带表格的文档，文件小巧、跨平台通用，转成 HTML 也几乎零成本。这篇就记录我从零学 Markdown 的真实过程，以及一路踩过的坑，给同样想入门的人一点参考——别被”标记语言”四个字吓到，它比想象中简单得多。而且因为它是纯文本，天然适合放进 Git 做版本管理，每次改动都有记录，再也不用担心笔记被自己改乱找不回来。

Markdown 基础语法：半小时就能上手

Markdown 的核心语法非常少，认真练半小时足够入门。我常用的大概这几类：

• 标题：用 # 到 ###### 表示一到六级标题，# 越多层级越深，用来搭文档骨架；
• 加粗与斜体：用 **文字** 加粗、*文字* 斜体，重点一眼就能标出来；
• 列表：用 – 做无序列表、用 1. 做有序列表，嵌套靠缩进；
• 代码：行内用 `代码`，多行用 “` 包裹成代码块，还能标语言做语法高亮；
• 引用与分隔线：用 > 做引用块、用 — 画一条分隔线，文章结构更清晰；
• 链接与图片：用 [文字](链接) 和  嵌入。

我练手的方法很简单：把每天学到的东西直接用 Markdown 记一遍，遇到不会的语法就查一下，记几次自然就会了。这和 我是怎么用学习笔记把知识真正记牢的：从随手记到体系化记录的方法与踩坑 里强调的一致——边学边写比光看教程记得牢得多，动手才是记忆的放大器。

我踩过的几个坑

语法看着简单，真写起来还是有几处容易翻车，我挨个说说：

1. 标题后面忘了空格

写成 “#标题” 不会被识别成标题，必须 “# 标题”（# 后空一格）。这个细节我踩过好几次，渲染出来还是普通文字，排查半天才发现是空格漏了。

2. 图片路径写错导致裂图

Markdown 图片用的是相对路径，文档一搬家图片就容易丢。我现在习惯把图片和文档放同一目录，或者统一传到图床再用网址引用，省得换设备就裂图。这个坑在写博客时尤其常见。

3. 表格和复杂排版对齐错位

表格用 | 和 – 拼接，刚学会时经常对齐错位、少一根竖线整个表就废了。我的办法是先用支持实时预览的编辑器写，确认渲染正常再保存，别等发布后才发现格式塌了。

4. 特殊字符和换行

像 *、#、< 这类符号在 Markdown 里有特殊含义，想当普通字符显示得加反斜杠转义；另外 Markdown 默认”单个换行不算段落”，想分段要么空一行，要么在行尾加两个空格。这两点我初期栽过跟头，后来养成习惯就好了。

配合工具让 Markdown 更好用

纯文本编辑器就能写，但配上工具体验会更好：轻量编辑器（如 Typora、VS Code）带实时预览，写完即所见即所得；需要发布到网站时，Markdown 转 HTML 几乎是零成本。我后来把笔记沉淀成网站，就是顺着这条路走的——参考 普通人也能上手：我从零搭建个人网站的学习笔记与踩坑实录，把 Markdown 文档直接转成网页，省去了重复排版的功夫。

如果还想做点自动化，比如批量把笔记转格式、定时归档、提取目录，可以看看 零基础学 Python 自动化：我写第一个小脚本的真实学习笔记与踩坑，用脚本批量处理 Markdown 文件，比手工快太多，也顺便练了手。

Markdown 进阶：任务列表、目录与脚注

基础语法够用之后，我陆续用上了几个进阶写法，体验提升明显。任务列表用 – [ ] 和 – [x] 表示待办和已完成，写学习计划、复盘清单特别直观，勾选状态一目了然；目录在部分编辑器里可以用 [TOC] 或手动锚点生成，长文档跳转方便；脚注用 [^1] 加底部说明，适合放参考资料而不打断正文。这些虽然不属于”最小可用集”，但一旦用熟就回不去了。

还有一点值得提：不同编辑器对扩展语法的支持不完全一致，比如表格在某些老渲染器里不生效。我的原则是只用最通用的子集，保证文档换到任何平台都能正常显示，不为花哨功能牺牲可移植性。比如脚注和任务列表在少数旧平台不支持，重要文档我会提前验证渲染效果，避免发出去才发现格式错乱。

我的日常记录工作流

现在我的流程基本固定：学到新东西 → 用 Markdown 记要点和代码 → 标好标题层级 → 需要分享就转 HTML 或导出 PDF。周末再统一回顾、合并同类笔记，慢慢形成自己的知识库。这套流程不依赖任何商业软件，文件丢在网盘或 Git 里就能同步，换电脑无缝衔接。

写在最后

Markdown 不是什么高深技术，但它极大降低了”记录”的门槛。我的建议是：别纠结哪款编辑器最好，先拿它把今天学到的东西记下来，在写的过程中语法自然就熟了。踩几次坑、查几次文档，你会发现技术笔记终于不再是负担，而是一种顺手的习惯——而这，恰恰是学习记录最珍贵的部分。