企业官网建设流程全解析

用 Typora 写东西的年头不算短了，从最早的免费版一路用到现在的正式版，中间换过三台电脑、迁移过几十个仓库的文档。最大的感受是：这软件默认状态只能算“能用”，离“顺手”差着一次认真配置的距离。很多人抱怨 Typora 图片老是丢、导出格式乱、写作时总要去点菜单，问题基本都不在软件本身，而在于快捷键没背、图片路径没配、必备设置还停在出厂值。

这篇就把我这些年沉淀下来的配置习惯一次讲清楚：常用命令怎么记、必备设置怎么调、图片路径怎么规划才不会在换电脑和同步时整片断链。内容偏实操，从完全没配置过的新手，到已经用了一阵但总觉得别扭的老用户，都能从里面挑到能直接抄的部分。其中涉及具体版本差异的地方，我会标出来提示你自行核对，因为不同版本和不同系统的默认绑定确实会有出入，这点必须先说在前面。

1. 先把 Typora 的“命令”和“设置”这两件事分清楚

1.1 三个层次：输入、存储、呈现

刚上手的人容易把所有问题混成一锅，其实 Typora 的所有配置项，落到根子上只服务三件事：输入效率、文件存储、呈现效果。输入效率对应的是快捷键和编辑行为，比如按一下加粗、按一下插入表格、输入列表时自动续行；文件存储对应的是图片路径、自动保存、相对路径策略；呈现效果对应的是主题、字体、代码块高亮、导出参数。

把这三层分开之后，你再看偏好设置里那一堆开关，就不会觉得凌乱。我的习惯是：输入层追求肌肉记忆，存储层追求可迁移，呈现层追求稳定不折腾。这三条原则决定了我后面所有的取舍。比如同样是图片路径，有人追求“上传到网络相册一劳永逸”，我追求“拷走整个文件夹就能在另一台机器上直接打开”，选的路子完全不同，没有对错，只有场景匹配。

之所以强调这个分层，是因为我见过太多人把精力花错了地方。花两小时调主题配色，结果图片路径还是绝对路径，一换电脑整篇文档全是裂图；反过来也有人把路径配得极其严谨，但每次加粗都要去工具栏点一下，一天下来多点几百次鼠标。两个方向都得顾，但先顾哪个，取决于你现在最大的痛点是“写得慢”还是“存不住”。

1.2 我自己的配置优先级排序

如果让我给一个刚装好 Typora 的人排个优先级，顺序大概是这样：图片路径 > 自动保存 > 快捷键 > Markdown 扩展语法 > 主题外观。前两项属于“不配就会出事”的类型，后三项属于“配了会更爽”的类型。

图片路径排第一，是因为它造成的损失不可逆。文档写完了、图片链接断了、原图又找不到，这种事故没法靠加班补救。自动保存排第二，是因为 Typora 本身的保存机制是“编辑后延迟写入”，默认行为在某些版本里并不可靠，尤其是断电、强制关机这类场景。快捷键排第三，它不会造成损失，只影响速度，而且是可以慢慢补的。

外观排最后，不是说它不重要，而是它最容易被过度投入。一个能看清字、行距舒服的默认主题，其实足够支撑长期写作。我自己的主题文件夹里躺过十几个改过的 CSS，最后常用的还是那个改了字体和行高的版本，其他花哨的功能一次没用上。

提示：配置这件事不要一次做完。先配图片路径和自动保存，用一周，把痛点记下来，再配快捷键。一次性改太多，出问题了你根本不知道是哪个开关引起的。

2. 快捷键：把高频动作从“找菜单”变成手指反射

2.1 必背的一批键位与我的记忆分组法

Typora 的默认快捷键覆盖得相当全，但全不等于好记。我的办法是按“动作类型”分成四组，一组一组地啃，比对着列表硬背效率高得多。

第一组是文档级操作，这是所有编辑器通用的，基本不用特意记：Ctrl+N新建、Ctrl+O打开、Ctrl+S保存、Ctrl+Shift+S另存为、Ctrl+W关闭当前文档、Ctrl+P快速打开（这个很好用，输入文件名片段就能跳，文档多了以后基本靠它）。

第二组是结构级操作，决定文档骨架：Ctrl+1到Ctrl+6分别对应一到六级标题，Ctrl+0把当前行变回普通段落。这几个键我建议强制自己用，因为点工具栏下拉框选标题级别实在太慢。配合使用的还有提升和降低标题级别的两个键，可以把一段文字在标题层级之间上下挪，改大纲结构时特别顺手。

第三组是格式级操作，也就是最常用的那批：Ctrl+B加粗、Ctrl+I斜体、Ctrl+U下划线、Ctrl+K插入链接、Ctrl+Shift+I插入图片、Ctrl+T插入表格、Ctrl+Shift+Q引用块。这一组里我使用频率最高的是Ctrl+K和Ctrl+Shift+I，因为写技术稿时链接和截图穿插得非常密。

第四组是视图与模式切换：Ctrl+/在实时渲染和源码模式之间切换，这个键排查渲染问题的时候必须用；F8专注模式，只高亮当前段落，其他部分变淡；F9打字机模式，让光标始终停在屏幕中部；F11全屏。源码模式这个键我强烈建议记住，后面讲问题排查会反复用到它。

下面这张表是我自己整理的高频键位，可以打印出来贴在显示器边上：

注意：上表是 Windows 和 Linux 下的常见默认绑定，macOS 上把 Ctrl 换成 Cmd 大体成立，但个别键位有出入。最可靠的做法是打开偏好设置里的快捷键面板，以那里显示的为准，面板里还能直接搜索动作名称，比翻文档快。

2.2 自定义快捷键的完整操作

默认键位用久了，总有一两个不趁手。Typora 允许改，而且改法不难，只是入口藏得比较深，很多人不知道。

第一步，打开偏好设置，找到“打开高级设置”那个按钮（不同版本位置略有差异，一般在通用或外观页面的底部），点它会直接弹出配置文件夹。第二步，在conf目录下找到conf.user.json，如果没有就自己新建一个，文件名必须是这个，扩展名必须是.json。第三步，按格式写进去，保存，然后完全退出 Typora 再重新打开，改键才会生效。

配置文件长这样：

{ "keyBinding": { "Toggle Source Code Mode": "Ctrl+Shift+M", "Insert Image": "Ctrl+Shift+P" } }

这里的关键是keyBinding里面的键名，必须是 Typora 内部的动作名，写错一个字母都不生效。动作名怎么找？最省事的办法是打开快捷键面板，把鼠标悬停在某一行上，通常在提示里能看到对应的命令标识；另一个办法是去看配置目录下那份默认的conf.default.json，里面收录了全部可绑定的动作名，直接照着抄最稳。

我踩过的坑是：一开始自己臆造了一个动作名，比如写成Toggle Source Mode（少了个 Code），结果整份配置文件被静默忽略，既不报错也不生效，我折腾了半天以为是路径问题。后来才想明白，这类配置文件基本都是“全有或全无”的策略，只要有一个键名不合法，整个文件可能都不被采纳。所以改完之后如果没效果，第一件事是把键名去默认配置里逐个核对，而不是怀疑软件坏了。

另外一个经验是：自定义键位不要覆盖掉太常用的默认键。我有一次把Ctrl+Shift+M抢过来做源码切换，结果原来绑在这个键上的功能用不了了，过了一个月才在某次写作中发现，那种“隐约觉得少了点什么”的感觉非常难受。改键之前先想清楚这个键原来在干什么，实在不确定就在面板里搜一下。

2.3 快捷键使用中的几个实际坑

第一个坑是输入法冲突。中文输入法在部分系统上会截获组合键，尤其是带 Shift 的组合，导致加粗、斜体按了没反应。表现是：英文输入法下一切正常，切到中文就失灵。解决办法是在输入法设置里把这几组键的快捷功能关掉，或者干脆养成“格式化操作前先确认输入法状态”的习惯。

第二个坑是表格内的键位行为不一致。在表格单元格里，Tab是跳到下一格，Shift+Tab是回上一格，Ctrl+Enter是在当前行下方插入新行。而Enter在单元格里是软换行，不会跳出表格。很多人第一次用表格时会疯狂按回车想换行，结果一直在格子里堆文字，把行高撑得很难看。

第三个坑是跨平台迁移后键位记忆错乱。我在 Windows 和 macOS 之间来回切的时候，最痛苦的就是 Cmd 和 Ctrl 的替换，尤其是那种“肌肉记忆已经形成，但手指按下去是错的”的状态，会让写作节奏变得断断续续。我的处理办法是不去强行统一，而是在两套系统上分别用各自的默认绑定，靠前几分钟的适应期过渡，比改键位强行统一要省心。

3. 图片路径：一篇图文稿最容易崩掉的地方

3.1 三种方案的取舍逻辑

图片路径这个事，本质上是回答一个问题：图片文件放在哪，文档里的引用怎么写。可选方案就三种，每种都有明确的适用边界。

绝对路径是默认行为，插入图片时直接记录文件在磁盘上的完整位置，比如C:/Users/xxx/Pictures/shot.png。这种方案只在一种场景下合理：文档永远不离开这台电脑，且图片永远不移动。一旦换机器、改文件夹名、或者把文档发给别人，链接立刻全断。我基本不用这个方案，只在临时草稿里图省事。

相对路径 + 本地图片文件夹是我最推荐的方案。做法是让 Typora 在插入图片时自动把图片复制到文档所在目录下的一个子文件夹里，文档里写的是./assets/文档名/图片.png这样的相对地址。好处非常明显：整个项目文件夹是一个自包含的整体，压缩打包发给别人，对方解压后直接双击打开，图片一张不少。很多技术文档仓库用的就是这个思路。

上传到网络图床适合内容需要公开发布的场景。图片存在远端，文档里写的是完整 URL，好处是文档本身很轻，坏处是对网络有依赖，而且一旦图床服务出问题，历史文档会集体裂图。这条路可以走，但不建议作为唯一方案，至少本地要留一份原始图片备份。

三者的对比如下：

3.2 从零配置相对路径的完整步骤

打开偏好设置，找到“图像”这一页，这里是整个配置的核心。我按操作顺序说。

第一，“插入图片时”那个下拉框选“复制到指定路径”或者“复制到 ./assets 文件夹”。前者可以自定义路径模板，后者是预设好的简化版。我用的自定义模板是./assets/${filename}，其中${filename}是当前文档的文件名（不含扩展名）。这样每篇文档的图片各自归到一个小文件夹里，几十篇文档放在同一个项目目录下也不会乱成一锅粥。

第二，勾选“优先使用相对路径”。这个选项是整套方案的关键，不勾的话，即使前面配了复制规则，文档里写的还是绝对地址，等于白配。很多人配完发现没效果，八成就是漏了这一勾。

第三，下面还有两个开关，分别是“对本地位置的图片应用上述规则”和“对网络位置的图片应用上述规则”。第一个必须勾上，否则从本地拖进来的图片不会被复制到 assets 目录。第二个看情况，我一般不勾，因为从网页粘贴的图片本来就是网络地址，强行下载到本地会让文档体积膨胀，而且后续更新图片也麻烦。

第四，如果你同时用上传服务，在“上传服务”那里选一个图像处理程序或者命令行工具，然后点“验证图片上传选项”测一下。不通过先别看文档，先把上传跑通，不然写一半发现传不上去会很难受。

配置完之后必须实测一次：新建一个文档保存到某个目录，然后截图直接粘贴进去，看两个地方——文档里写的路径是不是./assets/xxx/yyy.png这种相对形式，磁盘上是不是真的多出了一个 assets 文件夹。两个都对，配置才算成功。

提示：配置路径模板的时候，不要在开头加/或者盘符，那会变成绝对路径。模板必须是以./开头的相对形式，这个细节坑过不少人。

3.3 已有文档的图片迁移与修复

配置是给新文档用的，老文档里的图片还是绝对路径，怎么办？我这里有两个思路，看你的文档量。

文档量少的情况，手工处理最快。在源码模式下（Ctrl+/）打开文档，用查找替换把绝对路径的前缀统一替换成./assets/文档名/，然后把图片文件按对应关系拷进那个文件夹。注意替换的时候要保证文件名本身没变，只改前面的目录部分。

文档量大的情况，建议写个脚本批量处理。逻辑很简单：遍历目录下所有 Markdown 文件，用正则找出所有![...](路径)形式的图片引用，判断路径是不是绝对路径；如果是，就把图片文件复制到目标 assets 目录，同时把文档里的引用改写成相对路径。这个脚本用任何你熟悉的语言写都行，核心就是把“读文件、正则匹配、复制文件、替换文本、写回”这五步串起来。

不管用哪种方式，处理完都要抽样验证。我的习惯是随机挑三篇，在另一台机器上或者换一个目录打开，看看图片是不是都能正常显示。这个验证步骤不能省，我吃过一次亏：批量替换的时候正则写得太宽松，把一段本不该动的文本也替换了，结果文档里出现了几行乱码，当时没检查，过了半个月才发现。

3.4 上传服务的接入思路

如果你确实需要上传，Typora 支持把图片交给外部工具处理再回填链接。常见的做法是接入一个支持命令行调用的上传工具，在偏好设置的“上传服务”里选命令行方式，填入工具的可执行文件路径和参数。

这里的配置要点是参数格式必须严格匹配工具的要求。有些工具接受upload这样的子命令，有些要求直接把文件路径作为参数传进去。填错了的表现是验证时提示失败但看不出原因，建议先用终端手动跑一遍同样的命令，确认能出结果，再把命令搬进 Typora 的配置里。

另一个经验是上传服务的失败要有兜底。网络不稳的时候上传会超时，这时候 Typora 的行为可能是插入一个失效链接。我的做法是写作时先不勾“自动上传”，等整篇写完了，再统一处理图片。这样即使中途有失败，也能一次性重试，不会打断写作节奏。

4. 必备设置清单：把默认值改成适合长期写作的值

4.1 通用与编辑器页：几个必须调整的开关

偏好设置里的“通用”和“编辑器”两页，默认值偏保守，有几个我每次装机都会第一时间改掉。

自动保存。这个功能在新版本里是默认开启的，但不同版本对“多久保存一次”的处理不一样。打开它会明显降低丢稿风险，代价是磁盘写入更频繁，对固态硬盘来说这个开销可以忽略。需要注意的是：自动保存不等于版本管理，它只保留最新状态，误删内容之后是找不回来的。真要保底，还是得靠外部版本控制或者手动另存。

拼写检查。英文写作时有用，中文写作时基本是噪音——它会把大量中文段落里的英文缩写标红。我的做法是写中文稿时关掉，写英文稿或者中英混排时再打开。这个开关在编辑器页面，可以根据当前项目随时切。

智能标点。这个功能会自动把直引号转成弯引号、把连续两个短横线转成破折号。对正式排版是好事，对技术写作是灾难——代码片段里的引号被替换掉，复制出去就跑不起来了。我的建议是：写技术稿一律关掉，写纯文字稿可以开。这个开关藏得比较深，值得专门去找一下。

缩进与自动配对。自动配对括号和引号是双刃剑，写代码时很方便，写中文时会出现“你打一个左括号，它自动补右括号，你继续打字它又把右括号顶走”的错位感。如果觉得别扭，可以在编辑器页关掉自动配对，改成手动输入。

4.2 Markdown 扩展语法：哪些该开哪些该关

Typora 的一大优势是支持不少扩展语法，但全开并不一定是好事，有些语法会和你的写作习惯打架。

表格、任务列表、删除线、脚注这几个我建议常开。表格不用多说，任务列表在写待办和核查清单时非常顺手，删除线适合记录修订痕迹，脚注适合写技术稿时补充参考信息而不打断正文。

上下标看领域。写化学式、数学公式、或者需要表示平方立方的场合必须开，纯文字写作可以关掉，因为开了之后输入某些字符组合可能会被意外转换。

高亮标记（用双等号包裹的那种）我建议开。它在视觉上比加粗更醒目，适合标记“待确认”的段落。

数学公式如果你不写公式，建议关掉。开了之后，正文里出现美元符号的地方可能会被误判成公式起始，尤其是写价格、写变量的时候。这个误判不算严重，但会让渲染结果看起来很奇怪。

图表语法这块需要单独说一句：它渲染的是流程图时序图的语法块，但我不建议在技术文档里重度依赖它，因为很多下游平台不认这套语法，贴出去就变成一堆原始代码。流程图还是用截图或者纯文本描述更稳。

4.3 外观与主题：字体、字号与自定义 CSS

默认主题能用，但默认字号偏小，行距偏紧，长时间看容易累。我的调整顺序是：先把字号从默认值往上调一到两档，再把行距放宽一点，最后才考虑换主题配色。

字号调整在“外观”页，直接拖动或者输入数值，界面会实时预览。建议调到“坐在正常距离看屏幕不费劲”的程度，不必追求小字号带来的信息密度，长期写作眼睛舒服比什么都重要。行距如果外观页面没有直接暴露，就得靠自定义 CSS 了。

自定义 CSS 的操作路径是：外观页底部有个“打开主题文件夹”的按钮，点开之后能看到所有内置主题的.css文件。做法是复制一份现有主题，改个名字（比如在你原来的名字后面加个后缀），然后用文本编辑器打开修改。关键的两块是顶部的变量定义和正文字体设置：

:root { --side-bar-bg-color: #f7f7f7; --control-text-color: #666; } body { font-family: "Source Han Serif SC", "Noto Serif CJK SC", serif; font-size: 16px; line-height: 1.9; letter-spacing: 0.02em; }

改完保存，回到 Typora 在主题菜单里选你新建的那个名字，立刻生效，不用重启。这里有个坑：文件名里的空格和特殊字符可能导致主题不显示，命名尽量用简单的英文和连字符。

还有一个容易被忽略的点是导出和预览的字体可能不一致。你在界面上看着舒服的字体，导出 PDF 后可能被替换成别的，因为导出时的字体解析走的是另一套逻辑。如果对导出效果有要求，建议在自定义 CSS 里把字体栈写全，带上几个备选，减少被替换的概率。

4.4 导出与打印：几个影响交付质量的参数

导出这块平时不太碰，但真要用的时候参数不对，返工很麻烦。

导出 PDF 时，页边距和纸张大小是在导出对话框里设的，默认值对屏幕阅读友好，对打印不友好。如果是要打印出来的稿子，把页边距调到 2 厘米以上，字号保持和屏幕一致，行距适当收紧，一页能多放几行。

导出 Word 时，格式转换会丢掉一部分样式，尤其是自定义 CSS 里的东西。建议先用一篇短文档试导，看看标题层级、代码块、表格有没有变形，确认没问题再导正式稿。我遇到过一次导出的表格全部塌成纯文本，原因是表格里有合并单元格，而转换逻辑不支持。

导出图片格式适合发社交平台，它会把整篇文档渲染成一张长图。这里要注意长度限制，太长的文档会被截断或者压缩得很糊，建议按章节分开导。

5. 写作效率进阶：代码块、公式、表格与大纲

5.1 代码块的正确打开方式

Typora 的代码块有一个特性值得专门讲：语言标注。在代码块开头写三个反引号后面跟语言名，渲染时就会按对应语法高亮。这个语言名写得对不对，直接影响可读性。

```python def demo(): return True

常见的语言名有 `python`、`javascript`、`bash`、`sql`、`json`、`html`、`css`、`yaml` 这些，写错或者不写，代码块就是一大片灰底黑字，关键字全无区分。 我的习惯是**所有代码块都标语言**，哪怕是一段纯文本的配置也要标成 `text` 或者 `bash`，这样至少能保证等宽字体和换行行为一致。另外，代码块里如果包含反引号本身，要用四个反引号包裹，否则会被提前截断，这个细节在写教程类文档时经常遇到。 ### 5.2 公式、上下标与特殊符号 公式分两种：行内公式和独立公式块。行内公式用一对美元符号包裹，适合在句子里插一小段数学表达式；独立公式块用两对美元符号包裹，会居中单独成行，适合放推导过程。 输入体验上，公式语法是即时渲染的，一边打一边看到结果，写错了会有明显的红色提示。**常见的坑是空格和转义**：某些命令后面必须带空格，某些符号需要反斜杠转义，漏了就会渲染失败。遇到渲染不出来的情况，先把公式单独复制到一个新文档里试，排除了上下文干扰之后再定位具体是哪个字符的问题。 上下标在扩展语法开启之后，用一对波浪线包裹是下标，用一对脱字符包裹是上标。写单位、写化学式、写指数的时候很方便。但要注意，这两个语法和代码块里的内容会冲突，代码里的波浪线可能被误识别，写代码时最好把这段内容放进代码块里，避免被解析。 ### 5.3 表格的编辑技巧与对齐 Typora 的表格是可视化编辑的，插入之后可以直接在格子里打字，`Tab` 跳下一格，`Shift+Tab` 回上一格，`Ctrl+Enter` 在当前行下方插新行。这些键位练熟了之后，做参数对照表的速度非常快。 对齐方式在源码模式里是用冒号控制的：左边加冒号是左对齐，右边加冒号是右对齐，两边都加是居中。可视化模式下可以通过右键菜单设置，但我更推荐直接改源码，因为批量调整的时候改一次源码比点十次菜单快。 表格用多了会发现一个问题：**列宽是自动分配的，长内容会把某一列撑得很宽**。解决办法是在源码模式下给某几列的内容加上统一的换行控制，或者在单元格里用 `<br>` 手动换行。后者虽然不算纯 Markdown，但兼容性很好，导出的各种格式基本都能正确识别。 ### 5.4 大纲、文件树与快速跳转 文档一长，导航就成了效率瓶颈。Typora 左侧可以切换显示文件树和大纲，这两个视图配合快捷键使用效果最好。 大纲视图按标题层级列出结构，点击直接跳转。写作时的用法是：先搭好标题骨架，再往里填内容，填的过程中随时点大纲确认自己没跑偏。这个习惯对长文特别重要，我写超过三千字的东西，基本都是一边写一边看大纲，确保每一节都在该在的位置。 文件树视图适合管理多文档项目。配合快速打开功能，输入文件名片段就能跳过去，比在文件夹里翻找快得多。我的项目目录习惯是：一个主目录，下面按章节分文件，图片统一放 assets，这样文件树看起来清清爽爽。 还有一个不那么显眼但很好用的功能是**状态栏的字数统计**。写有篇幅要求的稿子时，随时瞄一眼心里有数，不用导出去用别的工具数。 ## 6. 踩坑实录：常见问题与排查速查 ### 6.1 图片类问题：三种典型故障 **故障一：图片显示为裂图，但文件明明存在。** 八成是路径写错了。排查顺序是：切到源码模式，看图片引用的具体路径，判断它是绝对路径还是相对路径；如果是相对路径，确认文档所在目录下有没有对应的子文件夹；再把路径和实际文件名逐字对比，注意大小写和空格。中文文件名在某些环境下会被编码，这也是常见原因，我的建议是**图片文件名一律用英文或数字**，从根上避开这个问题。 **故障二：粘贴图片后自动生成了一个奇怪的文件夹名。** 这是路径模板里的变量没配好。检查模板里 `${filename}` 拼写是否正确，有没有多余的空格。另外，如果文档还没保存过，也就是没有文件名，这个变量会取一个默认值，表现就是文件夹名很奇怪。**先保存文档，再粘图片**，这个顺序能避免大部分此类问题。 **故障三：把文档发给别人，对方打开全是裂图。** 这是绝对路径的典型后果。解决办法只有一个：把图片和文档一起打包发，并且文档里用的是相对路径。这也是我为什么一直在强调相对路径——它不是洁癖，是交付质量。 ### 6.2 显示与渲染类问题 **故障一：某段文字怎么改都不生效，或者格式乱套。** 先切源码模式看看有没有隐藏字符。从网页复制过来的内容经常带着不可见的格式标记，在渲染视图里看不见，但会干扰解析。源码模式下一眼就能看出来，手动删掉即可。 **故障二：代码块高亮失效。** 检查语言标注有没有写错，以及这个语言名在当前版本里是否被支持。有些冷门语言需要额外配置才认识。如果实在不行，标成 `text` 至少能保证等宽显示。 **故障三：公式渲染失败。** 先把公式单独拿出来测试，排除上下文干扰。常见原因是某个命令后面缺了空格，或者括号没有闭合。公式嵌套比较深的时候，建议一层一层地加，加一层看一次渲染结果，比写完一大坨再调试效率高得多。 ### 6.3 文件与保存类问题 **故障一：改了配置没生效。** 按这个顺序排查：配置文件路径对不对、JSON 语法有没有错误（多一个逗号都不行）、改完有没有完全退出重启、键名是否和默认配置里的完全一致。这四步能解决九成以上的配置问题。 **故障二：文档字数统计和预期差很多。** 检查是不是把代码块和公式也算进去了，不同版本对这两块的统计口径不一样。另外，如果文档里混了多语言，某些统计方式对中文的字符计算方式也有差异，不要指望精确到最后一位。 **故障三：导出后格式全乱。** 先确认导出目标格式对这些语法的支持程度，再确认自定义 CSS 有没有用到目标格式不认的属性。**最稳的办法是导出一份纯默认主题的版本作为对照**，如果默认主题正常、你的自定义主题异常，问题就锁定在 CSS 上；如果两者都异常，那就是语法本身不被支持。 ### 6.4 一张速查表收尾 | 现象 | 最可能的原因 | 第一步动作 | |---|---|---| | 图片裂图 | 路径为绝对地址或文件被移动 | 切源码模式看引用路径 | | 粘贴图片未自动归档 | 路径模板或相对路径开关未配 | 检查图像设置页三项配置 | | 快捷键无反应 | 输入法拦截或键位被覆盖 | 切英文输入法后重试 | | 配置改动无效 | JSON 语法错误或未重启 | 核对键名并完全退出重开 | | 格式错乱 | 隐藏字符或语法冲突 | 源码模式排查不可见标记 | | 代码块无高亮 | 语言名缺失或拼写错误 | 补上正确的语言标识 | | 导出样式丢失 | 目标格式不支持该语法 | 用默认主题导出做对照 | 这套配置在我手上跑了三年多，换过机器、同步过仓库、把文档打包发给过不少人，图片没再丢过一次。要说最值钱的一条经验，其实是**先配存储、再配效率**这个顺序——很多人一上来就折腾主题和键位，结果写了半年发现文档根本搬不走，那时候再回头改，工作量是现在的十倍。另外提醒一句，配置改完一定要实测，别只看设置页面打了勾就以为成了，粘一张图、存一次盘、导一次 PDF，三个动作各做一遍，比什么都可靠。