Typora 薄荷主题
薄荷主题在 Typora 里的样子(8 月 2 日实拍;打开的是仓库里的示例文稿)
我用 Markdown 写作软件 Typora 写文稿。这个项目给它一套薄荷绿的编辑主题,再配三种 PDF 样式:原版(中性,忠于原文)、个人(把薄荷主题搬进 PDF,字大行宽)、公司(墨蓝克制,不加任何品牌)。同一份 .md 一个字不改,选一种就导出一份,文件名后面分别带“-原版”“-个人”“-公司”。它自己不带 PDF 引擎,转换交给文稿转 PDF背后的转换器;新 PDF 查过没问题,才替换旧文件。
Typora 薄荷主题我用 Markdown 写作软件 Typora 写文稿。这个项目给它一套薄荷绿的编辑主题,再配三种 PDF 样式:原版(中性,忠于原文)、个人(把薄荷主题搬进 PDF,字大行宽)、公司(墨蓝克制,不加任何品牌)。同一份 .md 一个字不改,选一种就导出一份,文件名后面分别带“-原版”“-个人”“-公司”。它自己不带 PDF 引擎,转换交给文稿转 PDF背后的转换器;新 PDF 查过没问题,才替换旧文件。

薄荷主题在 Typora 里的样子(8 月 2 日实拍;打开的是仓库里的示例文稿)
平时怎么用
打开 Typora 就是薄荷主题:一级标题下面一道绿色渐变条,二级标题、引用和表格都是圆角浅绿卡片,代码块整块一个框。装一次就不用再管,切到别的主题再切回来也行。

文件 → 导出,菜单最下面有三项:“原版”“公司”“个人”,是本机 Typora 里配好的三条自定义导出命令。点一项,PDF 生成在文稿旁边,文件名带对应的后缀。9 月 29 日这三项换了新入口,还没在 Typora 里实际点过,待验收。

平时怎么用
打开 Typora 就是薄荷主题:一级标题下面一道绿色渐变条,二级标题、引用和表格都是圆角浅绿卡片,代码块整块一个框。装一次就不用再管,切到别的主题再切回来也行。

文件 → 导出,菜单最下面有三项:“原版”“公司”“个人”,是本机 Typora 里配好的三条自定义导出命令。点一项,PDF 生成在文稿旁边,文件名带对应的后缀。9 月 29 日这三项换了新入口,还没在 Typora 里实际点过,待验收。

三种 PDF 长什么样同一份示例文稿《春序 · 智能工作台方案简报》(虚构的公开样例),9 月 28 日现场导出三次,每份 2 页,导出前后原文的内容指纹(SHA-256)一样。下面是每份的第 1 页。

石墨黑字、细灰分隔线,像在 GitHub 上看 Markdown,不带任何主题色。适合只要干净排版的时候。

整套薄荷主题搬进 PDF:标题下的绿色渐变条、圆角浅绿卡片;打印正文 11.2 磅、行距 1.84。给自己反复读的。表头本该是主题的浅绿:这张图是 9 月 28 日导出的,表头还被转换器的默认样式盖成灰色,9 月 29 日已修好。

墨蓝标题左边一道竖线、深蓝表头、灰白分区。不加 logo、水印和客户名。给同事看的。
三张图都是对应 PDF 的第 1 页,由PDF 逐页检查转成图片。
三种 PDF 长什么样同一份示例文稿《春序 · 智能工作台方案简报》(虚构的公开样例),9 月 28 日现场导出三次,每份 2 页,导出前后原文的内容指纹(SHA-256)一样。下面是每份的第 1 页。

石墨黑字、细灰分隔线,像在 GitHub 上看 Markdown,不带任何主题色。适合只要干净排版的时候。

整套薄荷主题搬进 PDF:标题下的绿色渐变条、圆角浅绿卡片;打印正文 11.2 磅、行距 1.84。给自己反复读的。表头本该是主题的浅绿:这张图是 9 月 28 日导出的,表头还被转换器的默认样式盖成灰色,9 月 29 日已修好。

墨蓝标题左边一道竖线、深蓝表头、灰白分区。不加 logo、水印和客户名。给同事看的。
三张图都是对应 PDF 的第 1 页,由PDF 逐页检查转成图片。
出事怎么办它没有自动提醒;出了问题直接跟 AI 说,AI 按下面的办法处理。






出事怎么办它没有自动提醒;出了问题直接跟 AI 说,AI 按下面的办法处理。






一次导出经过哪几步





比较仓库和 Typora 里两个主题文件的指纹 → 不一样的先把旧的复制进 old-themes、文件名加上时间 → 用临时文件整个换上 → 再算一遍指纹,全对才报成功。别的主题、Typora 程序和授权都不碰。
| 部分 | 文件 | 行数 |
|---|---|---|
| 编辑主题 | 2 个 CSS | 720 |
| PDF 样式 | 3 个 CSS | 469 |
| 工具 | 6 个 Python、1 个 JS、1 个 PowerShell | 1031、43、13 |
| 测试 | 1 个 Python,22 项 | 456 |
一次导出经过哪几步





比较仓库和 Typora 里两个主题文件的指纹 → 不一样的先把旧的复制进 old-themes、文件名加上时间 → 用临时文件整个换上 → 再算一遍指纹,全对才报成功。别的主题、Typora 程序和授权都不碰。
数字截至 2026 年 11 月 6 日
为什么这样设计





公开仓库,MIT 许可;不含 Typora 程序、授权和 PDF 引擎。
为什么这样设计





公开仓库,MIT 许可;不含 Typora 程序、授权和 PDF 引擎。
导坏了,旧 PDF 也还在有的转换器什么都没生成,也会说“成功”。如果只看目标文件在不在,上次留下的旧 PDF 就会被当成这次的成果;要是直接写目标文件,转到一半出错,旧文件已经被写坏了。

新 PDF 先写到目标旁边的暂存文件里(名字很短,避开超长文件名;和目标在同一个文件夹,替换时不用跨盘搬)。转换器退出后查三样,全过才一次换上:
任何一样不过,旧 PDF 原样留着,暂存文件清掉;清理本身出错,也不会盖住真正的失败原因。
8 月 31 日这一版加了 230 行测试,下面四种情况旧 PDF 都没被换掉:
当时是 20 项测试;现在是 22 项,GitHub 自动测试最近一次在 10 月 20 日通过。
导坏了,旧 PDF 也还在
有的转换器什么都没生成,也会说“成功”。如果只看目标文件在不在,上次留下的旧 PDF 就会被当成这次的成果;要是直接写目标文件,转到一半出错,旧文件已经被写坏了。
新 PDF 先写到目标旁边的暂存文件里(名字很短,避开超长文件名;和目标在同一个文件夹,替换时不用跨盘搬)。转换器退出后查三样,全过才一次换上:
任何一样不过,旧 PDF 原样留着,暂存文件清掉;清理本身出错,也不会盖住真正的失败原因。
8 月 31 日这一版加了 230 行测试,下面四种情况旧 PDF 都没被换掉:
当时是 20 项测试;现在是 22 项,GitHub 自动测试最近一次在 10 月 20 日通过。
数字截至 2026 年 11 月 6 日
亮点
麻烦 Typora 会把主题文件夹里的每个 .css 都列进主题菜单,公共结构文件也会冒出来,变成一个点了就乱的“主题”。
解法 公共结构放进 verdant 子文件夹,菜单里只多出“Verdant Mint”一项;有一项测试守着“只露一个主题”。

示例样张:修好后的代码块,整段一个框,语法颜色照旧(8 月 2 日在浏览器里按 Typora 的代码块结构模拟生成,不是 Typora 实拍)
麻烦 Typora 1.14 把代码块里的每一行都画成一个单独的块,主题给代码块的圆角、底色和绿竖线就被套到了每一行上。
解法 主题里把代码块内部每一行的样式清掉,只在整块外面画一次框;有一项测试专门查。
亮点
麻烦 Typora 会把主题文件夹里的每个 .css 都列进主题菜单,公共结构文件也会冒出来,变成一个点了就乱的“主题”。
解法 公共结构放进 verdant 子文件夹,菜单里只多出“Verdant Mint”一项;有一项测试守着“只露一个主题”。

示例样张:修好后的代码块,整段一个框,语法颜色照旧(8 月 2 日在浏览器里按 Typora 的代码块结构模拟生成,不是 Typora 实拍)
麻烦 Typora 1.14 把代码块里的每一行都画成一个单独的块,主题给代码块的圆角、底色和绿竖线就被套到了每一行上。
解法 主题里把代码块内部每一行的样式清掉,只在整块外面画一次框;有一项测试专门查。
全部功能(16 项)在用=真的用过、现在照样能用(测试和写这页时的实跑不算);说不准=从 Typora 菜单导出不留记录,AI 的会话记录最早只到 9 月 1 日,查不清用没用过(9 月 28 日查所有硬盘时也没有一个带这三种后缀的 PDF,之后没有重查)。
编辑主题


导出 PDF





导出保护



配置和维护


全部功能(16 项)在用=真的用过、现在照样能用(测试和写这页时的实跑不算);说不准=从 Typora 菜单导出不留记录,AI 的会话记录最早只到 9 月 1 日,查不清用没用过(9 月 28 日查所有硬盘时也没有一个带这三种后缀的 PDF,之后没有重查)。
编辑主题


导出 PDF





导出保护



配置和维护


数字截至 2026 年 11 月 6 日
演进(2026 年)7 次提交,8 月 12 日到 10 月 20 日;8 月 31 日到 9 月 26 日之间只改过说明。10 月 20 日那次把导出要用的样式拼接单独拆出来,导出 PDF 不再依赖只给预览图用的 Pillow,并写明改了主题要当场重装、核对;导出步骤和三种样式没变,测试到 22 项,推送后 GitHub 自动测试通过。
演进(2026 年)7 次提交,8 月 12 日到 10 月 20 日;8 月 31 日到 9 月 26 日之间只改过说明。10 月 20 日那次把导出要用的样式拼接单独拆出来,导出 PDF 不再依赖只给预览图用的 Pillow,并写明改了主题要当场重装、核对;导出步骤和三种样式没变,测试到 22 项,推送后 GitHub 自动测试通过。
画廊点击图片,可以查看完整原图。

原版:中性的石墨文字和细分隔线(9 月 7 日用示例文稿实际导出的 PDF,1 页)。

个人版:薄荷色背景、更舒展的字号与间距。这张也是 9 月 7 日导出的,比 9 月 29 日修表头早,表头颜色以现在为准。

公司版:墨蓝标题和灰白分区,保持克制。三张用的是同一份示例文稿,没加客户、品牌或虚构内容。
画廊点击图片,可以查看完整原图。

原版:中性的石墨文字和细分隔线(9 月 7 日用示例文稿实际导出的 PDF,1 页)。

个人版:薄荷色背景、更舒展的字号与间距。这张也是 9 月 7 日导出的,比 9 月 29 日修表头早,表头颜色以现在为准。

公司版:墨蓝标题和灰白分区,保持克制。三张用的是同一份示例文稿,没加客户、品牌或虚构内容。
复制 AI 续作说明
项目:Typora 薄荷主题;仓库:wlyaaaaa/typora-theme-pack;范围:整个项目;目标:(这里写这次要做的事)。先读项目的 AGENTS.md 和说明,按现行规则做。
把“目标”换成这次要做的事,整段复制给 AI。

