Typora 薄荷主题
写东西时看着舒服,发出去的 PDF 按读者换样子。
现在
偶尔用 · 上次更新 10 月 20 日 16:21
三项导出菜单还没在 Typora 里实际点过
截至 11 月 6 日 · 项目修改记录和只读核对

薄荷主题在 Typora 里的样子(8 月 2 日实拍;打开的是仓库里的示例文稿)

1 套
编辑主题,Typora 现在用的就是它(已核对 Typora 设置)
3 种
PDF 样式:原版、个人、公司,同一份文稿选一种导一份
22 项
自动测试;GitHub 每次推送自动跑,最近一次是 10 月 20 日 16:55 推送后那次,通过
7 次
提交;最近一次在 10 月 20 日,导出 PDF 不再依赖只给预览图用的 Pillow,并约定改了主题当场重装、核对

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

Typora 薄荷主题
写东西时看着舒服,发出去的 PDF 按读者换样子。
现在
偶尔用 · 上次更新 10 月 20 日 16:21
三项导出菜单还没在 Typora 里实际点过
截至 11 月 6 日 · 项目修改记录和只读核对
1 套
编辑主题,Typora 现在用的就是它(已核对 Typora 设置)
3 种
PDF 样式:原版、个人、公司,同一份文稿选一种导一份
22 项
自动测试;GitHub 每次推送自动跑,最近一次是 10 月 20 日 16:55 推送后那次,通过
7 次
提交;最近一次在 10 月 20 日,导出 PDF 不再依赖只给预览图用的 Pillow,并约定改了主题当场重装、核对

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

薄荷主题在 Typora 里的样子(8 月 2 日实拍;打开的是仓库里的示例文稿)

平时怎么用
1. 写东西时它一直在

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

2. 从 Typora 菜单直接导出

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

3. 跟 AI 说

“这份周报用公司版导一份 PDF。”

“薄荷主题更新一下,旧的留着。”

“主题菜单里找不到薄荷了,查一下。”

AI 运行项目里的脚本;要逐页看排版,再交给PDF 逐页检查。

平时怎么用
1. 写东西时它一直在

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

2. 从 Typora 菜单直接导出

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

3. 跟 AI 说

“这份周报用公司版导一份 PDF。”

“薄荷主题更新一下,旧的留着。”

“主题菜单里找不到薄荷了,查一下。”

AI 运行项目里的脚本;要逐页看排版,再交给PDF 逐页检查。

三种 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 按下面的办法处理。

导出失败
旧 PDF 原样留着,这次生成到一半的临时文件清掉,报出转换器给的原因。不会拿一个坏文件或上次的旧文件冒充这次的成果。
找不到转换器
直接报错,并列出三种配法:在导出命令里指定、设一个环境变量,或者跑一次配置脚本记进本机配置。不会自己去找系统里别的打印程序。
导出时原文被改了
导出前后各算一次 .md 的指纹,对不上就不报成功。这只能发现改动,挡不住别的程序去改原文。
主题菜单里没有薄荷
先重启 Typora;还没有,让 AI 核对两个主题文件的指纹,不一致就重装。
想退回更新前的旧主题
旧文件在 Typora 主题文件夹的 old-themes 里,文件名带着时间。脚本没有一键还原,要手动拷回去。
换电脑
开发配置备份连同 Typora 的设置一起备份,主题文件和三条导出命令都在里面;命令里写着项目在 E 盘的位置,Python 每次按电脑配置里登记的那个找;新电脑上项目放的位置不同,重跑一次菜单配置脚本就行。
出事怎么办

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

导出失败
旧 PDF 原样留着,这次生成到一半的临时文件清掉,报出转换器给的原因。不会拿一个坏文件或上次的旧文件冒充这次的成果。
找不到转换器
直接报错,并列出三种配法:在导出命令里指定、设一个环境变量,或者跑一次配置脚本记进本机配置。不会自己去找系统里别的打印程序。
导出时原文被改了
导出前后各算一次 .md 的指纹,对不上就不报成功。这只能发现改动,挡不住别的程序去改原文。
主题菜单里没有薄荷
先重启 Typora;还没有,让 AI 核对两个主题文件的指纹,不一致就重装。
想退回更新前的旧主题
旧文件在 Typora 主题文件夹的 old-themes 里,文件名带着时间。脚本没有一键还原,要手动拷回去。
换电脑
开发配置备份连同 Typora 的设置一起备份,主题文件和三条导出命令都在里面;命令里写着项目在 E 盘的位置,Python 每次按电脑配置里登记的那个找;新电脑上项目放的位置不同,重跑一次菜单配置脚本就行。
一次导出经过哪几步
1
选样式
从 Typora 菜单点,或让 AI 运行导出脚本,选原版、个人或公司。
2
先记下原文
给 .md 算一个内容指纹;在目标文件旁边预约一个短名字的暂存文件。
3
备好 CSS
原版、公司各用自己的 CSS;个人版=薄荷主题的两份 CSS 加上个人版的大字号,拼成一份临时 CSS。转换器把正文放进和 Typora 编辑区同名的容器里,所以薄荷主题的样式不用改就能直接用在 PDF 上。
4
找转换器
按顺序找:命令参数 → 环境变量 → 本机配置。这台电脑配的是文稿转 PDF的转换脚本。
5
转换
Markdown 转成网页、套上 CSS,由 Playwright(浏览器自动化工具)驱动本机 Edge 按 A4 打印成 PDF。这一步归转换器,不属于本项目。
6
查过再换
原文指纹没变、PDF 读得开、至少 1 页,才一次替换成正式文件;
不过关,旧 PDF 不动
主题怎么装

比较仓库和 Typora 里两个主题文件的指纹 → 不一样的先把旧的复制进 old-themes、文件名加上时间 → 用临时文件整个换上 → 再算一遍指纹,全对才报成功。别的主题、Typora 程序和授权都不碰。

文件和代码
部分文件行数
编辑主题2 个 CSS720
PDF 样式3 个 CSS469
工具6 个 Python、1 个 JS、1 个 PowerShell1031、43、13
测试1 个 Python,22 项456
一次导出经过哪几步
1
选样式
从 Typora 菜单点,或让 AI 运行导出脚本,选原版、个人或公司。
2
先记下原文
给 .md 算一个内容指纹;在目标文件旁边预约一个短名字的暂存文件。
3
备好 CSS
原版、公司各用自己的 CSS;个人版=薄荷主题的两份 CSS 加上个人版的大字号,拼成一份临时 CSS。转换器把正文放进和 Typora 编辑区同名的容器里,所以薄荷主题的样式不用改就能直接用在 PDF 上。
4
找转换器
按顺序找:命令参数 → 环境变量 → 本机配置。这台电脑配的是文稿转 PDF的转换脚本。
5
转换
Markdown 转成网页、套上 CSS,由 Playwright(浏览器自动化工具)驱动本机 Edge 按 A4 打印成 PDF。这一步归转换器,不属于本项目。
6
查过再换
原文指纹没变、PDF 读得开、至少 1 页,才一次替换成正式文件;
不过关,旧 PDF 不动
主题怎么装

比较仓库和 Typora 里两个主题文件的指纹 → 不一样的先把旧的复制进 old-themes、文件名加上时间 → 用临时文件整个换上 → 再算一遍指纹,全对才报成功。别的主题、Typora 程序和授权都不碰。

文件和代码
部分文件行数
编辑主题
文件:
2 个 CSS
行数:
720
PDF 样式
文件:
3 个 CSS
行数:
469
工具
文件:
6 个 Python、1 个 JS、1 个 PowerShell
行数:
1031、43、13
测试
文件:
1 个 Python,22 项
行数:
456

数字截至 2026 年 11 月 6 日

为什么这样设计
编辑和交付分开选。
自己喜欢的薄荷绿不一定适合发给同事的文件。8 月 2 日我把话说清楚了:原版、个人、公司是 PDF 的样式和文件后缀,不是三个编辑主题。所以 Typora 里只有一个主题,PDF 另外选。
主题包不带 PDF 引擎。
它只管样式和把关,转换交给外面的转换器;换转换器只改一处配置。本机配置不进 Git,公开说明里不出现本机路径,有一项测试专门查。
正文不动,样式从外面套。
样式用单独的 CSS 文件交给转换器,默认忽略文稿里自带的样式;同一份 .md 出三种样子,不用存三份正文。
公司版不编造。
手上没有真的公司品牌材料,就不加 logo、水印、客户名,只用克制的墨蓝和灰白。
只动自己的两个文件。
装主题只写它自己的两个主题文件;测试用临时文件夹,不往真正的 Typora 主题文件夹里装。

公开仓库,MIT 许可;不含 Typora 程序、授权和 PDF 引擎。

为什么这样设计
编辑和交付分开选。
自己喜欢的薄荷绿不一定适合发给同事的文件。8 月 2 日我把话说清楚了:原版、个人、公司是 PDF 的样式和文件后缀,不是三个编辑主题。所以 Typora 里只有一个主题,PDF 另外选。
主题包不带 PDF 引擎。
它只管样式和把关,转换交给外面的转换器;换转换器只改一处配置。本机配置不进 Git,公开说明里不出现本机路径,有一项测试专门查。
正文不动,样式从外面套。
样式用单独的 CSS 文件交给转换器,默认忽略文稿里自带的样式;同一份 .md 出三种样子,不用存三份正文。
公司版不编造。
手上没有真的公司品牌材料,就不加 logo、水印、客户名,只用克制的墨蓝和灰白。
只动自己的两个文件。
装主题只写它自己的两个主题文件;测试用临时文件夹,不往真正的 Typora 主题文件夹里装。

公开仓库,MIT 许可;不含 Typora 程序、授权和 PDF 引擎。

导坏了,旧 PDF 也还在
麻烦

有的转换器什么都没生成,也会说“成功”。如果只看目标文件在不在,上次留下的旧 PDF 就会被当成这次的成果;要是直接写目标文件,转到一半出错,旧文件已经被写坏了。

解法

新 PDF 先写到目标旁边的暂存文件里(名字很短,避开超长文件名;和目标在同一个文件夹,替换时不用跨盘搬)。转换器退出后查三样,全过才一次换上:

原文的指纹和导出前一样
PDF 读得开,没有损坏
至少有 1 页

任何一样不过,旧 PDF 原样留着,暂存文件清掉;清理本身出错,也不会盖住真正的失败原因。

证据

8 月 31 日这一版加了 230 行测试,下面四种情况旧 PDF 都没被换掉:

转换器什么都不做
生成一个看着像 PDF 的假文件
生成 0 页的 PDF
转换器报错退出

当时是 20 项测试;现在是 22 项,GitHub 自动测试最近一次在 10 月 20 日通过。

导坏了,旧 PDF 也还在
麻烦

有的转换器什么都没生成,也会说“成功”。如果只看目标文件在不在,上次留下的旧 PDF 就会被当成这次的成果;要是直接写目标文件,转到一半出错,旧文件已经被写坏了。

解法

新 PDF 先写到目标旁边的暂存文件里(名字很短,避开超长文件名;和目标在同一个文件夹,替换时不用跨盘搬)。转换器退出后查三样,全过才一次换上:

原文的指纹和导出前一样
PDF 读得开,没有损坏
至少有 1 页

任何一样不过,旧 PDF 原样留着,暂存文件清掉;清理本身出错,也不会盖住真正的失败原因。

证据

8 月 31 日这一版加了 230 行测试,下面四种情况旧 PDF 都没被换掉:

转换器什么都不做
生成一个看着像 PDF 的假文件
生成 0 页的 PDF
转换器报错退出

当时是 20 项测试;现在是 22 项,GitHub 自动测试最近一次在 10 月 20 日通过。

数字截至 2026 年 11 月 6 日

亮点
1. 菜单里只多一项

麻烦 Typora 会把主题文件夹里的每个 .css 都列进主题菜单,公共结构文件也会冒出来,变成一个点了就乱的“主题”。

解法 公共结构放进 verdant 子文件夹,菜单里只多出“Verdant Mint”一项;有一项测试守着“只露一个主题”。

示例样张:修好后的代码块,整段一个框,语法颜色照旧(8 月 2 日在浏览器里按 Typora 的代码块结构模拟生成,不是 Typora 实拍)

2. 代码块不再每行一张卡片

麻烦 Typora 1.14 把代码块里的每一行都画成一个单独的块,主题给代码块的圆角、底色和绿竖线就被套到了每一行上。

解法 主题里把代码块内部每一行的样式清掉,只在整块外面画一次框;有一项测试专门查。

亮点
1. 菜单里只多一项

麻烦 Typora 会把主题文件夹里的每个 .css 都列进主题菜单,公共结构文件也会冒出来,变成一个点了就乱的“主题”。

解法 公共结构放进 verdant 子文件夹,菜单里只多出“Verdant Mint”一项;有一项测试守着“只露一个主题”。

示例样张:修好后的代码块,整段一个框,语法颜色照旧(8 月 2 日在浏览器里按 Typora 的代码块结构模拟生成,不是 Typora 实拍)

2. 代码块不再每行一张卡片

麻烦 Typora 1.14 把代码块里的每一行都画成一个单独的块,主题给代码块的圆角、底色和绿竖线就被套到了每一行上。

解法 主题里把代码块内部每一行的样式清掉,只在整块外面画一次框;有一项测试专门查。

全部功能(16 项)
图例:● 在用 ● 待验收 ○ 待实施 ● 没用过 ● 说不准 ✕ 已停用

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

编辑主题
1
薄荷编辑主题
Typora 里的薄荷绿阅读和编辑主题,标题、引用、表格、代码都有自己的样子
2
安装和核对主题
只复制两个主题文件,装完逐个比指纹;也能只核对不装。11 月 4 日核对两个文件都一致,不用重装
3
更新前留旧版
主题文件和仓库不一样时,先把旧的复制进 old-themes,文件名带时间
导出 PDF
4
原版 PDF
中性样式,石墨黑字、细灰线,文件名后缀“-原版”
5
个人 PDF
薄荷主题加大字号,文件名后缀“-个人”
6
公司 PDF
墨蓝、灰白,不加品牌,文件名后缀“-公司”
7
从 Typora 菜单导出
文件 → 导出里的“原版”“公司”“个人”三项,点一下就导出;9 月 29 日换了新入口,还没在 Typora 里点过
8
让 AI 导出
说哪份、用哪种,AI 运行导出脚本并报结果
9
指定位置和页数
可以指定 PDF 存哪、要求正好几页,页数不对就不交
导出保护
10
导坏不丢旧版
新 PDF 先暂存,查过才替换;不过关旧 PDF 原样留着
11
原文不被改写
导出前后比对 .md 的指纹,对不上就不报成功
12
不用文稿自带的样式
默认忽略 .md 里写的样式,只用选中的那一种;也可以改成保留或拒绝
13
不盖掉原文和转换器
输出路径等于原文或转换器时直接拒绝;输出必须是 .pdf
配置和维护
14
记下用哪个转换器
转换器路径记进本机配置,不进 Git;按命令参数、环境变量、本机配置的顺序找
15
效果预览
用公开样例生成软件概念图、代码块检查图、三种样式的页面图和拼图
16
自动测试
22 项测试查导出保护、文件名后缀、只露一个主题、代码块样式等;GitHub 每次推送自动跑,最近一次 10 月 20 日通过
全部功能(16 项)
图例:● 在用 ● 待验收 ○ 待实施 ● 没用过 ● 说不准 ✕ 已停用

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

编辑主题
1
薄荷编辑主题
Typora 里的薄荷绿阅读和编辑主题,标题、引用、表格、代码都有自己的样子
2
安装和核对主题
只复制两个主题文件,装完逐个比指纹;也能只核对不装。11 月 4 日核对两个文件都一致,不用重装
3
更新前留旧版
主题文件和仓库不一样时,先把旧的复制进 old-themes,文件名带时间
导出 PDF
4
原版 PDF
中性样式,石墨黑字、细灰线,文件名后缀“-原版”
5
个人 PDF
薄荷主题加大字号,文件名后缀“-个人”
6
公司 PDF
墨蓝、灰白,不加品牌,文件名后缀“-公司”
7
从 Typora 菜单导出
文件 → 导出里的“原版”“公司”“个人”三项,点一下就导出;9 月 29 日换了新入口,还没在 Typora 里点过
8
让 AI 导出
说哪份、用哪种,AI 运行导出脚本并报结果
9
指定位置和页数
可以指定 PDF 存哪、要求正好几页,页数不对就不交
导出保护
10
导坏不丢旧版
新 PDF 先暂存,查过才替换;不过关旧 PDF 原样留着
11
原文不被改写
导出前后比对 .md 的指纹,对不上就不报成功
12
不用文稿自带的样式
默认忽略 .md 里写的样式,只用选中的那一种;也可以改成保留或拒绝
13
不盖掉原文和转换器
输出路径等于原文或转换器时直接拒绝;输出必须是 .pdf
配置和维护
14
记下用哪个转换器
转换器路径记进本机配置,不进 Git;按命令参数、环境变量、本机配置的顺序找
15
效果预览
用公开样例生成软件概念图、代码块检查图、三种样式的页面图和拼图
16
自动测试
22 项测试查导出保护、文件名后缀、只露一个主题、代码块样式等;GitHub 每次推送自动跑,最近一次 10 月 20 日通过

数字截至 2026 年 11 月 6 日

演进(2026 年)
8 月 2 日
 装上薄荷主题;定下“一套编辑主题+三种 PDF 样式”,PDF 文件名后缀定为 -原版、-个人、-公司;同一天转换改由 Playwright 驱动 Edge
8 月 12 日
 整理成公开项目,发到 GitHub(32 个文件,8 项测试)
8 月 30 日
 转换器可以记进本机配置,Typora 菜单导出不用每次指定
8 月 31 日
 导出改成“先暂存、查过再换”,失败不丢旧 PDF;测试到 20 项
9 月 8 日
 旧网站用公开样例实拍三种 PDF
9 月 26 日
 说明改成人话,项目约定写进给 AI 的说明
9 月 28 日
 写这一页时重跑 21 项测试,现场导出三种样式各一份
9 月 29 日
 个人版 PDF 表头恢复浅绿;导出菜单改叫原版、公司、个人,改由启动脚本每次按电脑配置找 Python;测试到 21 项

7 次提交,8 月 12 日到 10 月 20 日;8 月 31 日到 9 月 26 日之间只改过说明。10 月 20 日那次把导出要用的样式拼接单独拆出来,导出 PDF 不再依赖只给预览图用的 Pillow,并写明改了主题要当场重装、核对;导出步骤和三种样式没变,测试到 22 项,推送后 GitHub 自动测试通过。

演进(2026 年)
8 月 2 日
 装上薄荷主题;定下“一套编辑主题+三种 PDF 样式”,PDF 文件名后缀定为 -原版、-个人、-公司;同一天转换改由 Playwright 驱动 Edge
8 月 12 日
 整理成公开项目,发到 GitHub(32 个文件,8 项测试)
8 月 30 日
 转换器可以记进本机配置,Typora 菜单导出不用每次指定
8 月 31 日
 导出改成“先暂存、查过再换”,失败不丢旧 PDF;测试到 20 项
9 月 8 日
 旧网站用公开样例实拍三种 PDF
9 月 26 日
 说明改成人话,项目约定写进给 AI 的说明
9 月 28 日
 写这一页时重跑 21 项测试,现场导出三种样式各一份
9 月 29 日
 个人版 PDF 表头恢复浅绿;导出菜单改叫原版、公司、个人,改由启动脚本每次按电脑配置找 Python;测试到 21 项

7 次提交,8 月 12 日到 10 月 20 日;8 月 31 日到 9 月 26 日之间只改过说明。10 月 20 日那次把导出要用的样式拼接单独拆出来,导出 PDF 不再依赖只给预览图用的 Pillow,并写明改了主题要当场重装、核对;导出步骤和三种样式没变,测试到 22 项,推送后 GitHub 自动测试通过。

复制 AI 续作说明

项目:Typora 薄荷主题;仓库:wlyaaaaa/typora-theme-pack;范围:整个项目;目标:(这里写这次要做的事)。先读项目的 AGENTS.md 和说明,按现行规则做。

把“目标”换成这次要做的事,整段复制给 AI。

完整尺寸