MarkText

　　一、图片不显示：从路径到缓存的逐项排查

　　图片问题排第一位，是因为社区里被问得最多。表现通常是：编辑器里能看到图，但导出的 HTML 或 PDF 里只剩一个破图占位符。排查时建议按下面这个顺序走，基本能定位到原因。

　　1. 路径写法要规范

　　MarkText 对相对路径非常敏感。把图片和 .md 文件放在同一目录是最省心的做法，引用时直接写  即可。如果图片散落在子文件夹，比如 assets/，路径要写成 ，前缀斜杠千万别多打。

　　避坑提醒：Windows 用户复制路径时常常带着反斜杠 \，MarkText 不认这种写法，务必手动改成正斜杠 /。

　　2. 格式与缓存问题

　　部分 WebP、AVIF 在低版本 MarkText 里不被识别，统一转成 PNG 或 JPG 就能恢复。另一类高频原因是缓存拖垮了图片加载——关闭软件后，删掉用户目录下的 marktext/cache 文件夹再重启，往往立竿见影。

　　二、MathJax 公式不渲染？多半是分隔符没设对

　　写技术博客或学习笔记时，公式渲染失败非常劝退。其实绝大部分情况不是 MarkText 本身的问题，而是分隔符与语法没对齐。下面这两个点，是新手最常踩的雷区。

　　1. 行内公式与行间公式

　　行内公式用 $...$，行间公式用 $$...$$，这是 MathJax 的默认约定。不少人习惯性写成 \(...\) 或 \\[...\\]，结果就出不来。建议在 设置 → Markdown → 公式 里把引擎明确选为 MathJax，并勾选"允许行内公式"，保存后重启一次软件。

　　2. 特殊符号要转义

　　下划线 _ 在 Markdown 里是斜体语法，写公式时如果变量名带下划线(比如 a_b)，最好改成 a\_{b}，否则会被吞掉一半字符。完整的 MarkText 公式配置教程，官网文档区有更详细的对照表，遇到 LaTeX 语法问题可以先去翻一翻。

　　三、文件同步：三条路各有利弊

　　MarkText 官方并没有内置云同步功能，所以"怎么把文件同步到另一台电脑"几乎是讨论区里的日经帖。下面三种方案，按使用成本从低到高排列，按自己的使用场景挑一条就行。

　　1. 坚果云 / OneDrive / iCloud 等网盘

　　把 .md 文件统一放在网盘同步目录下，是最省事的方法。优点是零学习成本，缺点是多端同时编辑可能产生冲突，网盘通常只保留时间最近的几版历史。

　　2. Git + 私有仓库

　　对程序员来说，Git 是最稳的方案。配一个 GitHub 或 Gitee 私有仓库，每次写完 git push 一下，回滚、分支、设备切换都顺带解决。配合 TortoiseGit 这种图形化客户端，不熟命令行的同学也能轻松上手。

　　3. 自建 WebDAV

　　如果对隐私要求比较高，可以自建一个 WebDAV 服务(用群晖、Nextcloud 都行)，再通过 rclone 挂载到本地当作同步盘使用。门槛稍高，但完全自主可控，适合有自建经验的用户。

　　四、文件被误删？四条恢复路径请按顺序尝试

　　"Ctrl+Z 救不回来"是 Markdown 用户最慌的瞬间。下面按成功率和操作成本，从易到难列出四种办法，越靠前越值得先试。

　　1. 编辑器自带的撤销栈

　　MarkText 启动时若检测到未保存内容，会自动生成 unsaved 备份文件，位于 ~/Documents/marktext/unsaved(Windows 用户在 用户/文档/marktext/unsaved)。这是恢复成本最低的一条路，建议平时就留意一下这个目录有没有东西。

　　2. 系统回收站 / 文件历史

　　如果文件是在资源管理器里被删的，回收站、Windows 的"文件历史记录"、macOS 的"时间机器"都可以直接还原，前提是事前开启过相关功能。这一步恢复率最高，但很多人平时压根没开过。

　　3. 网盘快照

　　前面提到把文件放在网盘同步目录的好处此刻就体现了——大多数网盘会保留 30 天内的历史版本，进入客户端右键就能一键回滚，不用任何额外工具。

　　3. 第三方数据恢复软件

　　上述三招都失效时，Recuva(Windows)或 Disk Drill(macOS)这类工具能扫到磁盘上的残留文件，但成功率随时间推移急剧下降，越早动手找回的概率越大。

　　五、总结：把 MarkText 用得更顺手的关键习惯

　　回顾这四类问题，根源往往不在 MarkText 本身，而是路径写法、公式分隔符、同步策略、备份意识这些"周边配置"没跟上。养成下面三个习惯，基本能避开 90% 的坑：

　　文件结构先行：建专门的写作目录，图片统一放子文件夹，路径保持相对化，避免引用绝对路径。

　　同步与备份分离：同步交给网盘或 Git，备份交给系统级工具或第三方快照，不要把鸡蛋放在一个篮子里。

　　版本意识常驻：重要的长文档，命名里加上日期或版本号(如 2026-产品方案-v2.md)，配合 Git 使用效果更佳。

　　MarkText 是一款仍在活跃更新的开源编辑器，遇到问题先查 mark-text.cn 下载 的文档与更新日志，往往比翻 GitHub Issue 更高效。希望这份 FAQ 能帮你少走一些弯路，把更多精力留给真正的写作本身。