目录
[toc]
这篇文章最开始只是我随手记下的一些 Typora 使用片段：图片怎么管理、有哪些主题好看、遇到微博图片防盗链怎么办。后来我自己也折腾了一套 Typora 主题，并且把它开源到 GitHub 之后，我发现这篇文章有必要重写一下。
因为对我来说，Typora 已经不只是一个“能打开 Markdown 的软件”。更准确地说，它是一个优秀的 Markdown 阅读器，顺便也是一个足够顺手的 Markdown 写作器。
这件事在 AI 时代反而更重要了。现在我们和 AI 沟通，越来越多时候不是只靠一句 prompt，而是把一套共识、一段背景、一个项目规则、一份设计文档沉淀到 Markdown 文件里。比如 README.md、AGENTS.md、CONTEXT.md、项目说明、写作草稿、会议纪要、知识库卡片，这些东西的 source of truth 经常就是一个 .md 文件。
如果你只是用记事本或者 VSCode 打开 Markdown，当然也能看。但问题是：能看，不等于愿意看；愿意看，也不等于能高效读完。
我的判断是，Typora 真正有价值的地方就在这里：它把 Markdown 从“带一堆符号的纯文本”变成了“结构清晰、排版舒服、读起来不累的文档”。颜值在这里不是装饰，而是生产力。
Typora 作为一个产品：它解决的不是写字，而是阅读体验
Typora 官方给自己的描述是一个 minimal Markdown editor and reader。这个定位很准确：它不是 Obsidian 那样的知识库系统，也不是 VSCode 那样的代码编辑器，更不是 Word 那样的传统排版软件。
Typora 更像是站在中间：
- 它保留 Markdown 的纯文本、可迁移、适合版本管理的优点；
- 它又把 Markdown 渲染成接近成品文档的样子，让人可以直接阅读和编辑；
- 它没有把你关进某个笔记数据库，文件仍然是你本地文件夹里的普通
.md文件。
所见即所得，让 Markdown 不再像“源码”
很多人第一次看到 Markdown，会觉得它像某种轻量代码：
1 | ## 二级标题 |
如果你熟悉 Markdown，这当然很清楚；但如果只是想读一份说明文档，这些符号会增加理解成本。
Typora 的思路是：你仍然写 Markdown，但它会在编辑时实时渲染。标题就是标题，表格就是表格，图片就是图片，代码块就是代码块。你需要修改时，光标进入对应区域，Markdown 标记再出现。
这是一种很适合长期写作和阅读的交互方式。它不像传统 Markdown 编辑器那样强迫你在“源码区”和“预览区”之间来回切换，也不像富文本编辑器那样把文档锁进复杂格式。
所以我更愿意把 Typora 理解为一种“低摩擦文档界面”：Markdown 仍然在底层，但平时阅读和修改时，人面对的是文档本身。
对不常写 Markdown 的用户，它降低了入门门槛
如果一个人平时不用 Markdown，只是偶尔需要打开别人发来的 .md 文件，Typora 的优势非常明显。
你不需要先知道什么是 GFM、什么是 fenced code block、什么是 frontmatter。你只要打开文件，就能看到一个排版后的文档：
- 标题层级清楚；
- 列表和任务清单可读；
- 表格不会挤成一团；
- 图片直接显示；
- 代码块有语法高亮；
- 左侧大纲可以快速跳转。
这对“只想读懂文档”的人很友好。
而对已经在用 VSCode 写 Markdown 的人来说，Typora 也不是替代关系。VSCode 适合批量编辑、项目工程、插件化工作流；Typora 更适合阅读、润色、导出和长文写作。我的实际用法经常是：工程文件在 VSCode 里处理，文档内容在 Typora 里阅读和打磨。
文件夹管理，让 Typora 可以承担轻量笔记系统
Typora 支持打开一个文件夹，并在侧边栏显示文件树或文件列表。这一点看起来很普通，但它让 Typora 可以承担一种非常朴素的笔记系统：
1 | notes/ |
它没有双链、标签图谱、数据库属性这些高级功能，但对于一些人来说，反而足够好：
- 文件夹就是分类；
- 文件名就是标题；
- Markdown 文件可以被 Git、网盘、博客系统、静态站点继续使用；
- 换工具时，不需要迁移数据库。
如果你追求复杂知识管理，Obsidian、Logseq、思源笔记可能更合适。但如果你只是想维护一组稳定的 Markdown 文档，Typora 的文件夹模式已经够用。
付费策略：从免费测试版到买断制
Typora 早期很长一段时间都处在测试版阶段，普通用户可以免费使用。2021 年 11 月，Typora 1.0 正式发布，结束测试版，开始要求购买许可证激活。
截至我重写这篇文章时（2026-05-14），Typora 官网商店显示的价格是 14.99 美元（不含税），提供 15 天免费试用；许可证是一次性购买，不是订阅制；一个许可证最多可以激活同一用户的 3 台设备。相关说明可以看官方的 Typora Store 和 Typora 1.0 更新说明。
我个人对这个付费策略是接受的。原因很简单：它是买断制，价格不算夸张，而且软件本身非常克制。如果一个工具能长期提升我阅读和整理 Markdown 文档的体验，我愿意为它付费。
当然，如果你的需求只是偶尔打开一个 .md 文件，或者更在意开源生态，那么也可以先看 VSCode、MarkText、Obsidian 等替代方案。但如果你经常读写 Markdown，尤其经常面对长文、主题样式、PDF 导出，我觉得 Typora 值得试用。
Markdown 只需要先会这些
Typora 的好处是，你不需要一上来就完整学习 Markdown 语法。先掌握下面这些，日常写笔记、写博客、写项目文档基本就够用了。
标题
1 | # 一级标题 |
标题不是为了把字体变大，而是为了表达结构。长文里最重要的不是“看起来大”，而是读者能不能通过标题迅速理解层次。
列表与任务清单
1 | - 普通列表 |
任务清单很适合放在项目文档、复盘文档、个人工作台里。它不一定要替代专业待办软件，但很适合表达“这份文档里还有什么没做”。
引用
1 | > 这是一段引用。 |
引用块适合放外部材料、关键结论、提醒事项。主题做得好不好，引用块往往一眼就能看出来，因为它很考验信息层级和留白。
代码与代码块
行内代码：
1 | 请运行 `npm run build`。 |
代码块：
1 | ```powershell |
如果你写技术文档，代码块的可读性非常重要。好的主题会让代码块看起来像一个独立的信息区域，而不是一坨灰色文本。
表格
1 | | 工具 | 适合场景 | 我的判断 | |
Markdown 表格手写起来不算舒服，但 Typora 提供了可视化表格编辑，这一点比纯文本编辑器友好很多。
图片
1 |  |
如果写博客或项目文档，我建议尽量使用相对路径管理图片。这样文档和图片文件夹可以一起移动，不容易断链。
目录
1 | [toc] |
Typora 会根据标题生成目录。写长文时，目录不只是给读者看的，也是给作者看的：如果目录一眼看不明白，正文通常也需要重构。
YAML Frontmatter
很多博客系统会在 Markdown 开头使用 frontmatter：
1 |
|
Typora 能正常识别和显示这类元信息。对写博客的人来说，这一点很方便。
我整理的一些 Typora 主题
Typora 的主题本质上是一组 CSS 文件。主题不只是换颜色，它会影响标题、正文、表格、代码块、引用块、图片、侧边栏、大纲、导出 PDF 的整体体验。
这也是我为什么说“颜值也是生产力”。好的主题能让文档结构更清楚，阅读停顿更自然，长时间盯屏幕时更不累。
Azure Series：我自己做的一套现代蓝色系主题
项目地址：HenryK39B5/azure-series-typora-theme
这是我自己整理和开发的一套 Typora 主题，包含 Azure Light 和 Azure Dark 两个版本。它的目标不是把 Typora 做得花哨，而是让 Markdown 写作界面更接近现代桌面 App：清爽、立体、克制，同时保留足够高的信息密度。
我做这套主题时，主要想解决两个问题。
第一个问题是屏幕阅读。Typora 默认主题能用，但有时候会更像传统文档样式。Azure Series 对代码块、引用块、图片、目录、文档元信息、侧边栏和大纲都做了更明确的视觉层级处理。比如代码块会更像 Mac 终端卡片，引用块更像杂志风 callout，图片有圆角和阴影，文内目录也更接近导航面板。
第二个问题是 PDF 导出。很多主题在屏幕上好看，但一导出 PDF 就暴露问题：页边距过大、代码块分页奇怪、表格被撑爆、标题和段落间距不稳定。Azure Series 单独写了打印样式，尽量让 A4 页面、表格密度、代码块高度、引用块留白和分页更适合真实使用。
它尤其适合这些场景：
- 在 Windows 上长期使用 Typora；
- 写学习笔记、课程资料、知识库和读书笔记；
- 写技术文档、代码说明、项目设计文档；
- 经常需要把 Markdown 导出成 PDF；
- 喜欢蓝色系、现代感、轻微圆角和层次感，但不想主题喧宾夺主。
安装方式也很简单：下载仓库后，把 src 目录下的 azure-light.css、azure-dark.css 和 azure-series/ 文件夹复制到 Typora 主题目录，重启 Typora 后就能在主题菜单里选择。
如果只推荐一套我自己的主题，那当然是它。毕竟自己家的孩子，还是要偏心一下。
Blackout：成熟的夜间写作主题
项目页：Blackout
Blackout 是我很喜欢的一套深色主题。它的定位很明确：做一个适合长期夜间写作的 Typora 主题。
它不是简单把背景涂黑，而是认真处理了深色环境下的文字清晰度、圆角、图片缩放、代码块、表格和侧边栏。它还有 Blackout Gamer 这种更适合展示和阅读的变体。
如果你经常晚上写文档，或者觉得 Typora 自带深色主题不够舒服，可以试试 Blackout。
Chernobyl：更有个性的深色主题
项目页：Chernobyl
Chernobyl 和 Blackout 都来自 ObscureFreeman 的主题体系，但气质不太一样。Blackout 更像成熟、耐看的夜间写作主题；Chernobyl 更有强烈的视觉个性，偏暗色、冷色、终端感，也带一点“废土科技”的味道。
这类主题不一定适合所有长文，但很适合技术笔记、代码文档、个人项目记录。它会让文档有更强的风格感。
Lapis：清爽蓝色系，适合中英文混排
项目页：Lapis
Lapis 是一套蓝色调的清爽主题，支持浅色和深色版本。它对中文和英文混排、代码配色、标题层级都处理得比较完整。
如果你喜欢偏学术、偏干净、带一点蓝色气质的文档风格，Lapis 是一个很稳的选择。它也是我做 Azure Series 时重点参考过的优秀主题之一。
Cement：像一张独立文档纸的主题
项目页：Cement
Cement 的特点是把写作区域做成更明确的文档卡片，有圆角、背景层次和比较完整的 UI 细节。它使用思源黑体、Fira Code 等字体方案，整体感觉偏现代、偏清爽。
如果你喜欢“页面本身像一张纸放在界面里”的感觉，Cement 会比较合适。
Mdmdt：简洁但定制很深的文档主题
项目页：Mdmdt
Mdmdt 是 Markdown Minimalism Document Theme 的缩写。它看起来是简洁风格，但其实对标题、表格、引用框、图片圆角、代码高亮、文件树、大纲、文档列表等都做了比较深的定制。
它还支持根据系统自动切换亮色/暗色，也提供单独的 light 和 dark 版本。对于喜欢简洁、现代、文档感强的用户，Mdmdt 很值得试。
Neumorphism：新拟态风格，视觉辨识度很强
Neumorphism 是新拟态风格主题，特点是柔和阴影、轻微浮雕感、界面元素像从背景里“长出来”。它不一定是最适合严肃论文或长时间代码阅读的主题，但视觉记忆点非常强。
如果你已经看腻了常规白底黑字主题，可以把它当作一个风格实验。它更适合个人写作、轻量笔记和展示型文档。
LaTeX Typora：把 Markdown 写出论文味
项目页：LaTeX Typora
我以前很喜欢把 Typora 伪装成 LaTeX 的思路，因为它非常适合课程论文、报告、学术笔记这类场景。现在 Typora 官方主题站里也有新的 LaTeX Typora 主题，提供浅色、深色和更适合代码阅读的开发者深色版本。
如果你的文档经常有公式、脚注、引用、长段落和类似论文的结构，这类主题会让 Markdown 更像一份正式文稿。
你也可以让 AI 帮你改出自己的 Typora 主题
写到这里，其实还有一个比“推荐主题”更有意思的点：现在 AI 的 coding 能力已经很强了，普通用户完全可以开始主动改造自己的工具。
Typora 主题本质上就是 CSS。它当然有一些 Typora 自己的选择器和细节坑，比如代码块、侧边栏、大纲、导出 PDF、Mermaid、frontmatter 等元素都要单独照顾。但它并不是一个神秘到普通用户完全不能碰的系统。
过去如果你想改一个主题，可能要先懂 HTML、CSS、Typora 的主题结构，还要会调试选择器。这个门槛不算特别高，但足够劝退很多人。现在不一样了。你可以用自然语言告诉 AI：
- 我希望正文更像现代桌面 App，而不是传统论文；
- 我希望代码块像 Mac 终端窗口；
- 我希望引用块不要是传统竖线，而是更像杂志里的重点段落；
- 我希望浅色模式适合白天读书笔记，深色模式适合晚上写技术文档；
- 我希望 PDF 导出不要留白太多，表格和代码块不要乱分页。
这些描述本来只是审美和使用感受，但 AI 可以把它们翻译成 CSS。你再把生成的 CSS 放进 Typora 主题目录，打开测试文档，看哪里不舒服，再继续让 AI 调整。这个循环就是很典型的 vibe coding。
我的 Azure Series 就是这样做出来的。更准确地说，它不是我坐下来一行一行手写出来的传统前端项目，而是我不断提出审美方向、使用场景和细节要求，再让 AI 帮我生成、修改、重构和排查问题。我负责判断什么是好看、什么是可读、什么是适合自己长期使用的；AI 负责把这些判断快速落到代码里。
这件事真正让我觉得有意思的地方，不是“人人都要成为 Typora 主题开发者”。而是它提醒我：工具界面并不一定只能被动接受。尤其在 AI 时代，一个普通用户也可以根据自己的阅读习惯、审美偏好和工作流，去调整工具的样子。
当然，我不建议直接修改 Typora 自带主题。更稳妥的做法是：
- 复制一份现有主题，再在副本上改；
- 把主题文件单独放进一个 Git 仓库，方便回滚；
- 准备一份测试文档，覆盖标题、列表、引用、代码块、表格、图片、公式、Mermaid 和 frontmatter；
- 每次大改后都导出 PDF 看一眼，避免屏幕上好看、导出后崩掉；
- 如果要公开发布，补充 README、安装说明、预览图和 License。
在我看来，这也是 Typora 很适合拿来练手的原因：它足够轻量，反馈足够快，成果又足够直观。你改完一套主题，马上就能在自己的文档里用上。
这可能也是这篇文章最后想说的更大一点的东西：AI 不只是帮我们写代码，它也在降低“改造工具”的门槛。以前我们只能在别人做好的界面里选择，现在我们可以开始把自己的审美、工作习惯和使用需求，变成真正可运行的东西。
一些 Typora 使用技巧
图片管理：优先使用相对路径
我的设置是让 Typora 把图片复制到当前文档旁边的资源目录：
1 | ./.${filename}.assets |
这样一篇文章会形成类似结构：
1 | 我的 Markdown 文档.md |
好处是文档和图片绑定在一起，迁移时不容易丢。如果后续要发布到博客，再统一把图片上传到图床或静态资源目录也比较清楚。
导出 PDF 前，先换到适合打印的主题
有些主题适合屏幕阅读，但不适合导出 PDF。导出前建议重点检查：
- 页边距是否太大；
- 标题是否被挤到页底；
- 代码块是否跨页断得难看；
- 表格是否撑破页面；
- 深色主题导出后是否仍然可读。
如果你经常导出 PDF，可以专门保留一套适合导出的主题。比如我的 Azure Series 就专门处理了 A4 页面和打印样式。
用测试文档检查主题，而不是只看一段正文
评价一个 Typora 主题，不能只看标题和正文。最好准备一份 “kitchen sink” 测试文档，里面放：
- H1-H6 标题；
- 普通列表、有序列表、任务列表；
- 引用块；
- 行内代码和代码块；
- 表格；
- 图片；
- 数学公式；
- Mermaid 图；
- frontmatter；
[toc]目录；- 导出 PDF 后的效果。
很多主题第一眼很好看，但一遇到表格、长代码、中文换行、PDF 导出就出问题。测试文档能帮你快速筛掉这些不稳定因素。
防盗链图片可以用中转链接，但不要过度依赖
我以前遇到过微博图片不能直接引用图片地址的问题。一个可用思路是通过中转链接处理，例如：
1 | <img src="https://image.baidu.com/search/down?url=https://wx2.sinaimg.cn/mw690/75782161ly1hplol7oqokj24ex2xykjo.jpg" referrerpolicy="no-referrer"> |
相关参考：图片防盗链最终解决方案（附详细使用和评测） - 龙鲲博客
不过我的建议是：如果是正式博客文章，最好还是把关键图片转存到自己的图床、对象存储或博客资源目录。中转链接能救急，但长期稳定性不可控。
我的结论
Typora 不是最强大的 Markdown 工具，但它是我很愿意推荐给普通用户的 Markdown 阅读器和写作器。
它真正打动我的地方不是功能堆得多，而是把“读 Markdown”这件事做得舒服。尤其在 AI 协作越来越依赖 Markdown 文档沉淀共识的今天，一个好的 Markdown 阅读器会直接影响我们吸收信息、维护上下文、复用知识的效率。
如果只用一句话概括我的推荐理由：
Markdown 负责让信息稳定、可迁移；Typora 负责让这些信息更容易被人读下去。
所以，如果你经常打开 .md 文件，却总觉得它们像源码、像草稿、像临时文本，我建议你试试 Typora。再配一套合适的主题，体验会完全不一样。
当然，工具最终还是为内容服务。主题可以让文档更好看，但真正重要的还是：你有没有把想法、规则、经验和共识写清楚。
这也是我现在越来越喜欢 Markdown 的原因。它不华丽，但稳定；它不复杂，但足够开放。配上 Typora 这样一个好看的阅读器，就很适合长期使用。
