Obsidian 插件 · v1.1.5 · MIT 开源

笔记写完,
公众号排版一键搞定

Markdown Publisher 把 Obsidian 笔记自动排版成公众号格式:CSS 全部内联、本地图片自动上传、KaTeX 公式与代码高亮开箱即用,直接发布到草稿箱。

18 排版主题 14 代码高亮 0 手动调格式
Features

为公众号排版而生的每一个细节

公众号编辑器会剥离外部样式表和大多数交互,这份"特殊性"全部由插件替你处理。

🎨

CSS 自动内联

基于 unified 渲染管线加 juice 内联,输出 HTML 直接适配公众号编辑器,粘贴即用。

🖼️

图片自动上传

本地与网络图片自动压缩并上传至微信素材 CDN,GIF 保留动画,SVG 自动转 PNG。

✍️

公式与表格

KaTeX 数学公式渲染、GFM 表格、任务列表、脚注一应俱全,技术写作无短板。

🌓

18 种排版主题 × 14 种代码高亮

从 Newsprint 纸墨感到 Neo-Brutalism 潮流感,搭配 GitHub、Dracula、Nord 等代码主题,还支持自定义 CSS 覆盖。

📤

直发草稿箱 + 草稿管理

填写标题、作者、摘要后直接调用微信草稿箱 API 存稿;也可随时查看、删除草稿箱中的历史草稿。

Live Demo

在线体验:粘贴即排版

在左侧粘贴 Markdown,右侧实时预览公众号排版效果。样式与插件一样直接内联到每个标签,选好主题即可一键复制,粘贴进公众号编辑器。

演示覆盖标题、加粗、行内代码、代码块、引用、列表与链接;完整排版能力以插件为准。
How to use

三步完成配置与发布

全程约 5 分钟。详细图文步骤见仓库中的 docs/USAGE.md

1

安装插件

Releases 页下载 main.jsmanifest.jsonstyles.css 三个文件,放入仓库的 .obsidian/plugins/md-publisher/ 目录,然后在「设置 → 第三方插件」中启用。(社区插件商店审核中)

2

配置微信公众号认证

在「设置 → Markdown Publisher」中二选一:自动模式填入 AppID 与 AppSecret,并把本机 IP 加入公众号后台的 IP 白名单;手动 token 模式直接粘贴后台获取的 access_token,无需白名单。填完点击「测试连接」验证。

💡 没有 IP 白名单条件?选手动 token 模式,token 约 2 小时更换一次
3

预览、复制或发布

点击左侧边栏 📄 图标(或命令面板执行「打开排版预览」)打开实时预览,选好主题后:复制到公众号编辑器粘贴,或点发布直接存入草稿箱,也可打开草稿面板管理历史草稿。

Themes

总有一款排版配得上你的文章

预览面板中即可实时切换。以下为部分主题:

Professional默认
Ayu Light清新
Terminal极客
Apple简约
Midnight暗色
Newsprint纸墨
Neo-Brutalism潮流
Retro复古

共 18 种排版主题、14 种代码高亮主题,均支持自定义 CSS 微调。

Notes

发布前需要知道的几件事

账号需要已认证的公众号

  • 发布与草稿管理依赖微信草稿箱 API,需要已认证的服务号或订阅号
  • AppID / AppSecret 位于「公众平台 → 设置与开发 → 基本配置」
  • 个人订阅号完成认证后同样可用

安全凭证只存在本机

  • AppSecret 以明文保存在本机 Obsidian 配置中,请勿共享配置文件
  • 自动模式要求把本机 IP 加入公众号的 IP 白名单
  • 不想配白名单时,改用手动 token 模式即可

环境桌面端专属

  • 插件仅支持 Obsidian 桌面版(macOS / Windows / Linux)
  • 要求 Obsidian v1.0.0 及以上
  • 图片上传前会按 quality 0.8 默认压缩,超大图请提前瘦身

发布两种产物任选

  • 复制 HTML:粘进公众号编辑器手动微调后再发
  • 直接发布:进草稿箱,可在手机或网页端终审后群发
  • 发布前务必在预览面板确认排版效果

下一篇文章,从排版工作中解放出来

免费、开源、本地运行。装上它,专注写作就好。