企业官网建设流程全解析

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 f"Hello, {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 + 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 常见问题速查与排查思路

实际使用中遇到的问题，八成集中在下面这几类，我整理成速查表：

排查的基本思路是先切源码模式看符号，再看渲染结果。绝大多数"渲染不对"的问题，切到源码模式一眼就能看出符号写错了。图片问题则优先怀疑路径，把图片地址复制出来在文件管理器里验证一下是否存在。

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]和几个标题占位，把结构定下来再动笔。这个动作只花三十秒，但能让你在写作过程中始终清楚"现在写到哪、接下来写什么"，长文档尤其管用。踩过几次写着写着结构散掉的坑之后，我现在已经离不开这个起手式了。