pi-markdown

把 PI-Desktop 插件 local.pi-markdown 的 Markdown 预览外观，移植成 Typora 主题 —— 配色、字号、间距、代码块样式都按插件源码里的声明逐条取值，不是凭观感模仿。

主题文件	Typora 菜单里显示为	说明
pi-markdown.css	Pi Markdown	浅色
pi-markdown-dark.css	Pi Markdown Dark	深灰（推荐）
pi-markdown-navy.css	Pi-markdown-navy	深蓝，面板黑夜档原值

安装

git clone https://github.com/sephiroth233/pi-markdown.git
cd pi-markdown
./install.sh

不想跑脚本的话，把 dist/ 里的 .css 手动复制到 Typora 的主题目录即可：

• macOS：~/Library/Application Support/abnerworks.Typora/themes/
• Windows：%APPDATA%\Typora\themes\
• Linux：~/.config/Typora/themes/

⚠️ 文件名别改。Typora 只认全小写、不带空格的文件名（内部规则 ^[^\sA-Z]+\.css）， 改名成 Pi Markdown.css 这类会被静默忽略、不出现在主题菜单里。

使用

1. 首次安装：退出并重新打开 Typora（主题菜单只在启动时扫描一次）， 然后 主题 → Pi Markdown（黑夜档在 偏好设置 → 外观 → 深色主题）。
2. 之后只是更新了 CSS 内容：切到别的主题再切回来即可重新注入，不用重启。

想先看效果又不想装：用浏览器打开 preview/preview-light.html 或 preview-dark.html。

examples/demo.md 是一份覆盖了全部样式的样张，可以在 Typora 里打开，和 PI-Desktop 的预览对着比。

想自己改

• 改配色：src/vars-light.css / src/vars-dark-gray.css / src/vars-navy.css 顶部的 :root 变量。
• 改排版：src/body.css（三档共用）；文件末尾有一段注释掉的「呼吸感」覆盖，取消注释即可放松间距。
• 改完跑 ./build.sh 重新生成 dist/，再 ./install.sh。

更细的东西（取值来源、与 Typora 内置样式的特异性冲突、深灰是怎么算出来的、验证方法）都在 docs/typora-theme-notes.md。

归属与许可

设计基准为 Typora 主题 Inkwell（MIT，Copyright © 2026 toxic-19）； 取值直接来源为 PI-Desktop 插件 local.pi-markdown（作者 Tioit-Wang）。本仓库以 MIT 许可发布，见 LICENSE。