Markdown 这门标记语言从诞生到现在已经快二十年了但真正让它从程序员圈子走进普通办公场景的是 Typora 这类所见即所得编辑器的出现。我最早接触 Markdown 是在写技术文档的时候那时候用纯文本编辑器敲#和*预览还得另开一个窗口写一篇长文来回切换几十次效率低得让人抓狂。后来换到 Typora左边敲字右边实时渲染的体验一下子把写作门槛拉低了大半——你不需要记住所有语法就能上手但要想真正把 Markdown 用出效率、用出规范光靠能打字远远不够。这份使用手册想解决的问题很具体让一个完全没接触过 Markdown 的人在半天之内能独立写出结构清晰、排版规范、可以直接交付的文档也让已经会用的人把那些藏在细节里的效率技巧和踩坑经验一次性补齐。不管你是写技术笔记、整理会议纪要、做项目文档还是单纯想找一个比 Word 更轻量的写作工具下面这些内容都能直接拿去用。1. 先搞清楚 Markdown 和 Typora 到底在解决什么问题1.1 Markdown 的本质用纯文本描述结构很多人第一次听到 Markdown 会以为它是一种软件或者某种特殊格式其实它就是一串约定俗成的纯文本符号。你用#表示一级标题用-表示列表项用**文字**表示加粗这些符号本身没有任何魔法任何文本编辑器都能打开。它的核心价值在于内容和格式分离你写的是结构语义至于最终长什么样交给渲染器去决定。这个设计带来的好处非常实际。第一文件体积极小一个几万字的文档通常也就几十 KB传输和备份毫无压力。第二纯文本天然适合版本管理每一次修改都能精确到行不像二进制文档那样改一个字整个文件就变了。第三跨平台兼容性极好Windows、macOS、Linux 甚至手机上都能打开编辑。第四格式转换成本低同一份源文件可以导出成 HTML、PDF、Word 等多种格式不用重复排版。我个人的体会是Markdown 最适合写结构比样式重要的内容。技术文档、读书笔记、需求说明、周报总结这类东西读者关心的是信息层次清不清楚而不是字体好不好看。反过来如果你要做一份需要精细控制版面、图文混排的海报式文档那 Markdown 就不是最优解别硬套。1.2 Typora 的定位把标记语法藏起来的编辑器传统 Markdown 编辑器的模式是源码区 预览区左右分栏你得一边敲符号一边看右边渲染结果。Typora 走的是另一条路——即时渲染你敲下#的瞬间这一行就变成了标题样式符号本身被隐藏起来光标移开才显示。这种体验更接近 Word但底层存的仍然是纯文本。这个设计选择背后有明确的取舍。优点是写作时注意力集中在内容上不用频繁切换视线缺点是初学者容易看不见语法导致某些需要精确控制的地方比如表格对齐、嵌套列表反而不好调。我的建议是日常写作开着即时渲染没问题但遇到复杂结构时按Ctrl /切换到源码模式看一眼确认符号写对了再切回来这个习惯能省掉大量为什么渲染不对的困惑。Typora 另一个被低估的能力是导出。它内置了 PDF、HTML、Word、图片等多种导出格式配合自定义 CSS 主题同一份源文件可以产出风格完全不同的成品。我做项目交付时经常这么干源文件维护一份给客户的 PDF 套正式主题内部传阅的 HTML 套简洁主题一次编写多处复用。1.3 适合谁学、学到什么程度够用这份手册的读者大致分三类。第一类是零基础办公人群平时用 Word 写文档想找一个更轻、更快、格式更稳定的替代品那重点看第二、三章的语法和排版就够了。第二类是技术从业者需要写 README、接口文档、技术方案那除了基础语法还要重点关注代码块、表格、目录生成这些章节。第三类是内容创作者用 Markdown 写公众号草稿、博客文章那导出和主题定制部分值得多花时间。学到什么程度算够用我的判断标准很简单能不看语法表凭肌肉记忆写出带标题层级、列表、表格、代码块、链接和图片的完整文档并且知道导出时怎么控制最终样式这就已经覆盖 90% 的日常场景了。剩下的高级语法脚注、数学公式、流程图属于按需查阅的范畴不用一开始就背。2. 基础语法把常用符号练成肌肉记忆2.1 标题、段落与换行的三个关键规则标题用#的数量表示层级#是一级######是六级注意#和文字之间必须有一个空格这是新手最高频的错误#标题是不会被识别的。我建议一篇文章只用一到三级标题层级太深读者会迷失而且导出 PDF 时目录会显得非常臃肿。段落之间用空行分隔这是 Markdown 和 Word 最大的习惯差异。在 Word 里你按回车就是新段落在 Markdown 里单个回车只是换行渲染出来还是同一段。想要真正的段落间隔必须敲两个回车留一个空行。这个规则一开始会让人不适应但习惯之后你会发现它强制你把内容按逻辑分块写出来的东西反而更有条理。至于段内换行有两种写法行尾加两个空格或者直接用br标签。前者更纯 Markdown但空格在编辑器里看不见容易丢后者更可靠但混入了 HTML。我的习惯是能用空行分段就不用段内换行实在需要比如诗歌、地址才用br。提示Typora 默认开启了严格模式相关的换行处理如果你发现空行没生效检查偏好设置里的 Markdown 扩展选项是否被改动过。2.2 强调、列表与引用的组合技巧强调分三种*斜体*、**加粗**、***加粗斜体***。这里有个细节星号和文字之间不能有空格** 文字 **在部分渲染器里会失效。另外中文环境下星号紧贴中文是没问题的但如果你在英文单词中间用下划线_斜体_要注意单词边界snake_case_name这种就会被误判。无序列表用-、或*开头加空格有序列表用1.加空格。嵌套列表靠缩进实现通常是两个或四个空格Typora 里直接按Tab键最省事。这里踩过的坑是不同渲染器对缩进空格数要求不一致两个空格在某些平台会失效四个空格兼容性最好我统一用四个。引用用开头支持嵌套和内部嵌套其他语法。引用块特别适合放注意事项和引用他人观点视觉上和正文有明显区隔。我写文档时习惯把所有警告类信息都放进引用块读者扫一眼就能定位到关键提醒。列表和引用还能组合出很实用的效果比如在引用块里放一个待办清单 本周待办 - [x] 完成接口文档初稿 - [ ] 补充异常码说明 - [ ] 和前端对齐字段命名这种写法在项目协作里特别好用- [ ]和- [x]渲染出来就是可勾选的复选框比纯文字列表直观得多。2.3 链接、图片与路径处理的实战经验链接语法是[显示文字](地址)图片是区别只多一个感叹号。看起来简单但图片路径是实际使用中最容易出问题的地方。图片地址分两种网络图片和本地图片。网络图片直接填 URL优点是换电脑也能显示缺点是链接失效就挂了本地图片填相对路径或绝对路径优点是稳定缺点是文件移动后可能找不到。我的做法是项目文档统一建一个assets或images文件夹图片全部用相对路径引用整个文件夹打包传输到哪都能正常显示。相对路径的写法要注意./images/a.png表示当前文件同级目录下的 images 文件夹../images/a.png表示上一级目录。Typora 有个很贴心的功能直接拖拽图片进编辑器它会自动复制到指定目录并插入相对路径在偏好设置里把插入图片时设为复制到指定路径填好./assets之后所有图片都自动管理省心很多。注意如果你用 Typora 写的内容要发布到其他平台本地相对路径的图片是传不上去的发布前记得把图片单独上传或改用图床地址。2.4 代码块、行内代码与表格的规范写法行内代码用反引号包裹比如Ctrl C适合标注快捷键、变量名、文件名。代码块用三个反引号开头结尾并在开头反引号后标注语言类型def greet(name): return fHello, {name}标注语言类型的好处是渲染时会自动语法高亮读者一眼能看出这是 Python 还是 JavaScript。我见过很多人代码块不标语言渲染出来一片灰可读性差很多。常用语言标识有python、javascript、bash、json、sql、html、css记不住也没关系Typora 输入三个反引号后会弹出语言列表让你选。表格用|分隔列第二行用---定义对齐方式| 语法 | 作用 | 对齐 | | :--- | :---: | ---: | | # | 标题 | 左对齐 | | ** | 加粗 | 居中 | | - | 列表 | 右对齐 |:---左对齐:---:居中---:右对齐。表格的坑在于列数必须严格一致少一个竖线整个表格就崩了。Typora 里可以用Ctrl T直接插入表格然后像 Excel 一样操作比手敲竖线快得多。表格内容里如果要写竖线|得用\|转义否则会被当成列分隔符。3. Typora 的高效操作与个性化配置3.1 必须改的五个默认设置Typora 装好之后的默认配置对中文用户并不友好我每次换电脑都会先改这五项第一自动保存。偏好设置里把自动保存打开间隔设为 1 分钟。Markdown 文件小自动保存几乎无感但能避免断电丢稿的惨剧。第二图片插入行为。设为复制图片到 ./assets 文件夹并勾选对本地图片应用规则。这样拖进来的图片自动归档文档目录永远干净。第三换行符。Windows 用户注意把默认换行符设为 LF 而不是 CRLF否则文件传到 Linux 或 Git 仓库里会出现整篇已修改的假象。第四拼写检查。中文写作时英文拼写检查会疯狂标红直接在偏好设置里关掉或者只对英文段落开启。第五主题字体。默认主题的中文字体偏细长时间阅读眼睛累。打开主题 CSS 文件把font-family里加上系统中文字体如微软雅黑苹方字号调到 16px 左右阅读体验提升明显。3.2 快捷键与效率操作清单Typora 的快捷键设计得很克制常用的就那么十几个练熟之后手不用离开键盘操作快捷键使用频率切换源码模式Ctrl /高插入表格Ctrl T高插入链接Ctrl K高插入图片Ctrl Shift I中插入代码块Ctrl Shift K高一级到六级标题Ctrl 1~6高无序列表Ctrl Shift ]中有序列表Ctrl Shift [中引用Ctrl Shift Q中搜索Ctrl F高全局搜索文件Ctrl Shift F中跳转到行Ctrl G低除了快捷键还有几个隐藏操作值得记Ctrl 鼠标点击大纲面板的标题可以折叠对应章节选中文字后按Ctrl B加粗、Ctrl I斜体Ctrl Shift C复制为 Markdown 格式粘贴到其他编辑器里格式不丢。3.3 主题定制让导出文档有交付感Typora 的主题本质是一个 CSS 文件放在偏好设置里能打开的 themes 目录下。想改样式复制一份现有主题改名然后改 CSS 就行。我常用的几个定制点正文行高调到 1.8中文阅读更舒服标题加一条底部细线层级更清晰代码块背景改成浅灰和正文区分开表格加边框导出 PDF 时不至于糊成一片。这些改动都不需要懂前端找到对应的选择器改数值即可。如果不想自己写 CSS网上有大量现成主题可以直接下载放进 themes 目录在菜单里切换即可。但要注意主题只影响 Typora 内的显示和 PDF 导出导出 HTML 时样式是内联的导出 Word 时主题基本不生效Word 的样式得靠 pandoc 的参考文档来控制。提示改主题 CSS 前先备份原文件改坏了直接还原比一点点找问题快得多。4. 从写作到交付完整实操流程与问题排查4.1 一份规范文档的完整写作流程我拿写一份项目技术方案举例走一遍完整流程你可以直接套用。第一步建目录结构。新建项目文件夹里面放方案.md和assets文件夹。打开 Typora偏好设置里确认图片自动复制到./assets。第二步搭骨架。先只写标题层级把整篇文档的章节结构列出来比如背景、目标、方案设计、实施计划、风险与应对。这一步不写正文只定结构避免写着写着跑偏。第三步填内容。每个章节下先写要点再扩成段落。需要图的地方直接拖图片进来需要代码的地方用代码块。写的过程中随时Ctrl S虽然开了自动保存手动保存一下更安心。第四步加目录。在文档开头输入[TOC]然后回车Typora 会自动根据标题生成目录而且会随内容变化实时更新。导出 PDF 时目录也会带上非常省事。第五步通读校对。按Ctrl /切到源码模式检查有没有漏写的符号、错位的表格、失效的图片路径。重点看列表缩进和表格列数这两个最容易出错。第六步导出交付。菜单里选导出 → PDF选好主题确认页码和目录正常。如果要给不装 Typora 的人看导出 HTML 更合适双击就能在浏览器打开。4.2 常见问题速查与排查思路实际使用中遇到的问题八成集中在下面这几类我整理成速查表现象可能原因解决办法标题不生效#后缺空格补一个空格加粗不生效星号与文字间有空格去掉空格表格错乱某行列数不一致逐行数竖线数量图片不显示路径错误或文件被移动改用相对路径并检查目录列表嵌套失效缩进空格数不对统一用四个空格或 Tab导出 PDF 中文乱码主题字体不含中文主题 CSS 里加中文字体代码块不高亮未标注语言类型反引号后加语言标识空行没分段只敲了一个回车敲两个回车留空行目录不更新[TOC]未重新渲染点击目录或重新切换视图文件在 Git 里全变红换行符 CRLF/LF 混用统一设为 LF排查的基本思路是先切源码模式看符号再看渲染结果。绝大多数渲染不对的问题切到源码模式一眼就能看出符号写错了。图片问题则优先怀疑路径把图片地址复制出来在文件管理器里验证一下是否存在。4.3 几个让我少走弯路的实操心得第一个心得别在 Typora 里写超长单文件。超过五千字的文档拆成多个 md 文件用一个索引文件链接起来维护和查找都方便。Typora 支持文件内跳转[跳到第二节](#2-基础语法)这种锚点链接在导出 HTML 后依然有效。第二个心得善用复制为 Markdown。从网页或聊天记录里复制内容时用Ctrl Shift C复制粘进来格式是干净的 Markdown不会带一堆乱七八糟的样式。反过来从 Typora 复制到微信或邮件时直接Ctrl C会带格式粘到不支持富文本的地方就变成纯文本按需选择。第三个心得版本管理用 Git但别提交 assets 里的大图。图片多了仓库会膨胀得很快在.gitignore里把assets/*.png之类的大文件排除或者用 Git LFS 管理这个习惯在团队协作里能省很多事。第四个心得导出 Word 别指望 Typora 原生功能。Typora 导出 Word 的效果一般真要交付 Word 文档用 pandoc 配合自定义参考文档reference.docx样式控制精细得多。命令大致是pandoc 方案.md -o 方案.docx --reference-doc模板.docx模板里把标题、正文、表格样式调好导出来就是规范的公司文档格式。第五个心得定期清理未引用的图片。写久了 assets 文件夹里会堆积大量删掉段落留下的孤儿图片隔一段时间用脚本扫一遍把没被任何 md 文件引用的图片删掉文件夹能瘦身一半以上。5. 进阶语法与扩展能力按需取用的工具箱5.1 脚注、任务列表与数学公式脚注的写法是正文里写[^1]文末写[^1]: 注释内容渲染出来是一个可点击的上标数字。适合放补充说明、参考来源不打断正文阅读节奏。任务列表前面已经提过- [ ]和- [x]在项目管理和读书笔记里特别实用。数学公式用$包裹行内公式$$包裹独立公式块语法是 LaTeX。比如$E mc^2$渲染成行内公式独立公式块适合写多行推导。Typora 内置了公式渲染不需要额外配置。这块对理工科写作者价值很大但对普通办公场景基本用不上按需学即可。5.2 图表与流程图的文本化表达Typora 支持用特定语法的代码块画流程图、时序图、甘特图本质是把图形描述成文本。这类语法在技术文档里画架构图、时序图很方便源文件可读可改比贴图片强。但要注意不同平台对这类语法的支持程度不一样导出 HTML 或发布到某些博客平台时可能渲染不出来重要图表建议同时保留一张导出的图片作为兜底。我的实际做法是内部文档用文本图表方便修改对外交付的文档文本图表导出成图片再插入保证任何环境都能正常显示。这个取舍在跨平台协作里很重要别为了纯文本牺牲了可用性。5.3 与其他工具的衔接pandoc 与静态站点Markdown 的真正威力在于它是很多工具的通用输入格式。pandoc 能把 md 转成几十种格式静态站点生成器如各类博客框架直接吃 md 文件生成网页笔记软件之间也大多支持 md 导入导出。这意味着你花时间学的这套语法在换工具时不会白费。我个人的工作流是Typora 负责写作和本地预览pandoc 负责格式转换和批量处理Git 负责版本管理三者串起来就是一条完整的文档生产线。这套组合的学习成本不高但一旦跑通写文档的效率和质量会有明显提升。最后分享一个我用了很久的小习惯新建任何 md 文件时先敲一个[TOC]和几个标题占位把结构定下来再动笔。这个动作只花三十秒但能让你在写作过程中始终清楚现在写到哪、接下来写什么长文档尤其管用。踩过几次写着写着结构散掉的坑之后我现在已经离不开这个起手式了。
Markdown 这门标记语言从诞生到现在已经快二十年了但真正让它从程序员圈子走进普通办公场景的是 Typora 这类所见即所得编辑器的出现。我最早接触 Markdown 是在写技术文档的时候那时候用纯文本编辑器敲#和*预览还得另开一个窗口写一篇长文来回切换几十次效率低得让人抓狂。后来换到 Typora左边敲字右边实时渲染的体验一下子把写作门槛拉低了大半——你不需要记住所有语法就能上手但要想真正把 Markdown 用出效率、用出规范光靠能打字远远不够。这份使用手册想解决的问题很具体让一个完全没接触过 Markdown 的人在半天之内能独立写出结构清晰、排版规范、可以直接交付的文档也让已经会用的人把那些藏在细节里的效率技巧和踩坑经验一次性补齐。不管你是写技术笔记、整理会议纪要、做项目文档还是单纯想找一个比 Word 更轻量的写作工具下面这些内容都能直接拿去用。1. 先搞清楚 Markdown 和 Typora 到底在解决什么问题1.1 Markdown 的本质用纯文本描述结构很多人第一次听到 Markdown 会以为它是一种软件或者某种特殊格式其实它就是一串约定俗成的纯文本符号。你用#表示一级标题用-表示列表项用**文字**表示加粗这些符号本身没有任何魔法任何文本编辑器都能打开。它的核心价值在于内容和格式分离你写的是结构语义至于最终长什么样交给渲染器去决定。这个设计带来的好处非常实际。第一文件体积极小一个几万字的文档通常也就几十 KB传输和备份毫无压力。第二纯文本天然适合版本管理每一次修改都能精确到行不像二进制文档那样改一个字整个文件就变了。第三跨平台兼容性极好Windows、macOS、Linux 甚至手机上都能打开编辑。第四格式转换成本低同一份源文件可以导出成 HTML、PDF、Word 等多种格式不用重复排版。我个人的体会是Markdown 最适合写结构比样式重要的内容。技术文档、读书笔记、需求说明、周报总结这类东西读者关心的是信息层次清不清楚而不是字体好不好看。反过来如果你要做一份需要精细控制版面、图文混排的海报式文档那 Markdown 就不是最优解别硬套。1.2 Typora 的定位把标记语法藏起来的编辑器传统 Markdown 编辑器的模式是源码区 预览区左右分栏你得一边敲符号一边看右边渲染结果。Typora 走的是另一条路——即时渲染你敲下#的瞬间这一行就变成了标题样式符号本身被隐藏起来光标移开才显示。这种体验更接近 Word但底层存的仍然是纯文本。这个设计选择背后有明确的取舍。优点是写作时注意力集中在内容上不用频繁切换视线缺点是初学者容易看不见语法导致某些需要精确控制的地方比如表格对齐、嵌套列表反而不好调。我的建议是日常写作开着即时渲染没问题但遇到复杂结构时按Ctrl /切换到源码模式看一眼确认符号写对了再切回来这个习惯能省掉大量为什么渲染不对的困惑。Typora 另一个被低估的能力是导出。它内置了 PDF、HTML、Word、图片等多种导出格式配合自定义 CSS 主题同一份源文件可以产出风格完全不同的成品。我做项目交付时经常这么干源文件维护一份给客户的 PDF 套正式主题内部传阅的 HTML 套简洁主题一次编写多处复用。1.3 适合谁学、学到什么程度够用这份手册的读者大致分三类。第一类是零基础办公人群平时用 Word 写文档想找一个更轻、更快、格式更稳定的替代品那重点看第二、三章的语法和排版就够了。第二类是技术从业者需要写 README、接口文档、技术方案那除了基础语法还要重点关注代码块、表格、目录生成这些章节。第三类是内容创作者用 Markdown 写公众号草稿、博客文章那导出和主题定制部分值得多花时间。学到什么程度算够用我的判断标准很简单能不看语法表凭肌肉记忆写出带标题层级、列表、表格、代码块、链接和图片的完整文档并且知道导出时怎么控制最终样式这就已经覆盖 90% 的日常场景了。剩下的高级语法脚注、数学公式、流程图属于按需查阅的范畴不用一开始就背。2. 基础语法把常用符号练成肌肉记忆2.1 标题、段落与换行的三个关键规则标题用#的数量表示层级#是一级######是六级注意#和文字之间必须有一个空格这是新手最高频的错误#标题是不会被识别的。我建议一篇文章只用一到三级标题层级太深读者会迷失而且导出 PDF 时目录会显得非常臃肿。段落之间用空行分隔这是 Markdown 和 Word 最大的习惯差异。在 Word 里你按回车就是新段落在 Markdown 里单个回车只是换行渲染出来还是同一段。想要真正的段落间隔必须敲两个回车留一个空行。这个规则一开始会让人不适应但习惯之后你会发现它强制你把内容按逻辑分块写出来的东西反而更有条理。至于段内换行有两种写法行尾加两个空格或者直接用br标签。前者更纯 Markdown但空格在编辑器里看不见容易丢后者更可靠但混入了 HTML。我的习惯是能用空行分段就不用段内换行实在需要比如诗歌、地址才用br。提示Typora 默认开启了严格模式相关的换行处理如果你发现空行没生效检查偏好设置里的 Markdown 扩展选项是否被改动过。2.2 强调、列表与引用的组合技巧强调分三种*斜体*、**加粗**、***加粗斜体***。这里有个细节星号和文字之间不能有空格** 文字 **在部分渲染器里会失效。另外中文环境下星号紧贴中文是没问题的但如果你在英文单词中间用下划线_斜体_要注意单词边界snake_case_name这种就会被误判。无序列表用-、或*开头加空格有序列表用1.加空格。嵌套列表靠缩进实现通常是两个或四个空格Typora 里直接按Tab键最省事。这里踩过的坑是不同渲染器对缩进空格数要求不一致两个空格在某些平台会失效四个空格兼容性最好我统一用四个。引用用开头支持嵌套和内部嵌套其他语法。引用块特别适合放注意事项和引用他人观点视觉上和正文有明显区隔。我写文档时习惯把所有警告类信息都放进引用块读者扫一眼就能定位到关键提醒。列表和引用还能组合出很实用的效果比如在引用块里放一个待办清单 本周待办 - [x] 完成接口文档初稿 - [ ] 补充异常码说明 - [ ] 和前端对齐字段命名这种写法在项目协作里特别好用- [ ]和- [x]渲染出来就是可勾选的复选框比纯文字列表直观得多。2.3 链接、图片与路径处理的实战经验链接语法是[显示文字](地址)图片是区别只多一个感叹号。看起来简单但图片路径是实际使用中最容易出问题的地方。图片地址分两种网络图片和本地图片。网络图片直接填 URL优点是换电脑也能显示缺点是链接失效就挂了本地图片填相对路径或绝对路径优点是稳定缺点是文件移动后可能找不到。我的做法是项目文档统一建一个assets或images文件夹图片全部用相对路径引用整个文件夹打包传输到哪都能正常显示。相对路径的写法要注意./images/a.png表示当前文件同级目录下的 images 文件夹../images/a.png表示上一级目录。Typora 有个很贴心的功能直接拖拽图片进编辑器它会自动复制到指定目录并插入相对路径在偏好设置里把插入图片时设为复制到指定路径填好./assets之后所有图片都自动管理省心很多。注意如果你用 Typora 写的内容要发布到其他平台本地相对路径的图片是传不上去的发布前记得把图片单独上传或改用图床地址。2.4 代码块、行内代码与表格的规范写法行内代码用反引号包裹比如Ctrl C适合标注快捷键、变量名、文件名。代码块用三个反引号开头结尾并在开头反引号后标注语言类型def greet(name): return fHello, {name}标注语言类型的好处是渲染时会自动语法高亮读者一眼能看出这是 Python 还是 JavaScript。我见过很多人代码块不标语言渲染出来一片灰可读性差很多。常用语言标识有python、javascript、bash、json、sql、html、css记不住也没关系Typora 输入三个反引号后会弹出语言列表让你选。表格用|分隔列第二行用---定义对齐方式| 语法 | 作用 | 对齐 | | :--- | :---: | ---: | | # | 标题 | 左对齐 | | ** | 加粗 | 居中 | | - | 列表 | 右对齐 |:---左对齐:---:居中---:右对齐。表格的坑在于列数必须严格一致少一个竖线整个表格就崩了。Typora 里可以用Ctrl T直接插入表格然后像 Excel 一样操作比手敲竖线快得多。表格内容里如果要写竖线|得用\|转义否则会被当成列分隔符。3. Typora 的高效操作与个性化配置3.1 必须改的五个默认设置Typora 装好之后的默认配置对中文用户并不友好我每次换电脑都会先改这五项第一自动保存。偏好设置里把自动保存打开间隔设为 1 分钟。Markdown 文件小自动保存几乎无感但能避免断电丢稿的惨剧。第二图片插入行为。设为复制图片到 ./assets 文件夹并勾选对本地图片应用规则。这样拖进来的图片自动归档文档目录永远干净。第三换行符。Windows 用户注意把默认换行符设为 LF 而不是 CRLF否则文件传到 Linux 或 Git 仓库里会出现整篇已修改的假象。第四拼写检查。中文写作时英文拼写检查会疯狂标红直接在偏好设置里关掉或者只对英文段落开启。第五主题字体。默认主题的中文字体偏细长时间阅读眼睛累。打开主题 CSS 文件把font-family里加上系统中文字体如微软雅黑苹方字号调到 16px 左右阅读体验提升明显。3.2 快捷键与效率操作清单Typora 的快捷键设计得很克制常用的就那么十几个练熟之后手不用离开键盘操作快捷键使用频率切换源码模式Ctrl /高插入表格Ctrl T高插入链接Ctrl K高插入图片Ctrl Shift I中插入代码块Ctrl Shift K高一级到六级标题Ctrl 1~6高无序列表Ctrl Shift ]中有序列表Ctrl Shift [中引用Ctrl Shift Q中搜索Ctrl F高全局搜索文件Ctrl Shift F中跳转到行Ctrl G低除了快捷键还有几个隐藏操作值得记Ctrl 鼠标点击大纲面板的标题可以折叠对应章节选中文字后按Ctrl B加粗、Ctrl I斜体Ctrl Shift C复制为 Markdown 格式粘贴到其他编辑器里格式不丢。3.3 主题定制让导出文档有交付感Typora 的主题本质是一个 CSS 文件放在偏好设置里能打开的 themes 目录下。想改样式复制一份现有主题改名然后改 CSS 就行。我常用的几个定制点正文行高调到 1.8中文阅读更舒服标题加一条底部细线层级更清晰代码块背景改成浅灰和正文区分开表格加边框导出 PDF 时不至于糊成一片。这些改动都不需要懂前端找到对应的选择器改数值即可。如果不想自己写 CSS网上有大量现成主题可以直接下载放进 themes 目录在菜单里切换即可。但要注意主题只影响 Typora 内的显示和 PDF 导出导出 HTML 时样式是内联的导出 Word 时主题基本不生效Word 的样式得靠 pandoc 的参考文档来控制。提示改主题 CSS 前先备份原文件改坏了直接还原比一点点找问题快得多。4. 从写作到交付完整实操流程与问题排查4.1 一份规范文档的完整写作流程我拿写一份项目技术方案举例走一遍完整流程你可以直接套用。第一步建目录结构。新建项目文件夹里面放方案.md和assets文件夹。打开 Typora偏好设置里确认图片自动复制到./assets。第二步搭骨架。先只写标题层级把整篇文档的章节结构列出来比如背景、目标、方案设计、实施计划、风险与应对。这一步不写正文只定结构避免写着写着跑偏。第三步填内容。每个章节下先写要点再扩成段落。需要图的地方直接拖图片进来需要代码的地方用代码块。写的过程中随时Ctrl S虽然开了自动保存手动保存一下更安心。第四步加目录。在文档开头输入[TOC]然后回车Typora 会自动根据标题生成目录而且会随内容变化实时更新。导出 PDF 时目录也会带上非常省事。第五步通读校对。按Ctrl /切到源码模式检查有没有漏写的符号、错位的表格、失效的图片路径。重点看列表缩进和表格列数这两个最容易出错。第六步导出交付。菜单里选导出 → PDF选好主题确认页码和目录正常。如果要给不装 Typora 的人看导出 HTML 更合适双击就能在浏览器打开。4.2 常见问题速查与排查思路实际使用中遇到的问题八成集中在下面这几类我整理成速查表现象可能原因解决办法标题不生效#后缺空格补一个空格加粗不生效星号与文字间有空格去掉空格表格错乱某行列数不一致逐行数竖线数量图片不显示路径错误或文件被移动改用相对路径并检查目录列表嵌套失效缩进空格数不对统一用四个空格或 Tab导出 PDF 中文乱码主题字体不含中文主题 CSS 里加中文字体代码块不高亮未标注语言类型反引号后加语言标识空行没分段只敲了一个回车敲两个回车留空行目录不更新[TOC]未重新渲染点击目录或重新切换视图文件在 Git 里全变红换行符 CRLF/LF 混用统一设为 LF排查的基本思路是先切源码模式看符号再看渲染结果。绝大多数渲染不对的问题切到源码模式一眼就能看出符号写错了。图片问题则优先怀疑路径把图片地址复制出来在文件管理器里验证一下是否存在。4.3 几个让我少走弯路的实操心得第一个心得别在 Typora 里写超长单文件。超过五千字的文档拆成多个 md 文件用一个索引文件链接起来维护和查找都方便。Typora 支持文件内跳转[跳到第二节](#2-基础语法)这种锚点链接在导出 HTML 后依然有效。第二个心得善用复制为 Markdown。从网页或聊天记录里复制内容时用Ctrl Shift C复制粘进来格式是干净的 Markdown不会带一堆乱七八糟的样式。反过来从 Typora 复制到微信或邮件时直接Ctrl C会带格式粘到不支持富文本的地方就变成纯文本按需选择。第三个心得版本管理用 Git但别提交 assets 里的大图。图片多了仓库会膨胀得很快在.gitignore里把assets/*.png之类的大文件排除或者用 Git LFS 管理这个习惯在团队协作里能省很多事。第四个心得导出 Word 别指望 Typora 原生功能。Typora 导出 Word 的效果一般真要交付 Word 文档用 pandoc 配合自定义参考文档reference.docx样式控制精细得多。命令大致是pandoc 方案.md -o 方案.docx --reference-doc模板.docx模板里把标题、正文、表格样式调好导出来就是规范的公司文档格式。第五个心得定期清理未引用的图片。写久了 assets 文件夹里会堆积大量删掉段落留下的孤儿图片隔一段时间用脚本扫一遍把没被任何 md 文件引用的图片删掉文件夹能瘦身一半以上。5. 进阶语法与扩展能力按需取用的工具箱5.1 脚注、任务列表与数学公式脚注的写法是正文里写[^1]文末写[^1]: 注释内容渲染出来是一个可点击的上标数字。适合放补充说明、参考来源不打断正文阅读节奏。任务列表前面已经提过- [ ]和- [x]在项目管理和读书笔记里特别实用。数学公式用$包裹行内公式$$包裹独立公式块语法是 LaTeX。比如$E mc^2$渲染成行内公式独立公式块适合写多行推导。Typora 内置了公式渲染不需要额外配置。这块对理工科写作者价值很大但对普通办公场景基本用不上按需学即可。5.2 图表与流程图的文本化表达Typora 支持用特定语法的代码块画流程图、时序图、甘特图本质是把图形描述成文本。这类语法在技术文档里画架构图、时序图很方便源文件可读可改比贴图片强。但要注意不同平台对这类语法的支持程度不一样导出 HTML 或发布到某些博客平台时可能渲染不出来重要图表建议同时保留一张导出的图片作为兜底。我的实际做法是内部文档用文本图表方便修改对外交付的文档文本图表导出成图片再插入保证任何环境都能正常显示。这个取舍在跨平台协作里很重要别为了纯文本牺牲了可用性。5.3 与其他工具的衔接pandoc 与静态站点Markdown 的真正威力在于它是很多工具的通用输入格式。pandoc 能把 md 转成几十种格式静态站点生成器如各类博客框架直接吃 md 文件生成网页笔记软件之间也大多支持 md 导入导出。这意味着你花时间学的这套语法在换工具时不会白费。我个人的工作流是Typora 负责写作和本地预览pandoc 负责格式转换和批量处理Git 负责版本管理三者串起来就是一条完整的文档生产线。这套组合的学习成本不高但一旦跑通写文档的效率和质量会有明显提升。最后分享一个我用了很久的小习惯新建任何 md 文件时先敲一个[TOC]和几个标题占位把结构定下来再动笔。这个动作只花三十秒但能让你在写作过程中始终清楚现在写到哪、接下来写什么长文档尤其管用。踩过几次写着写着结构散掉的坑之后我现在已经离不开这个起手式了。
