公众号一键发布工作流详细教程
在 Obsidian 里完成写作、插图和预览，最后通过插件把整篇文章复制到微信公众号后台。文字格式、标题层级、引用、代码块和本地图片都可以一起带过去，省掉手动排版和逐张上传图片的时间。
来自视频：一键发布公众号！codex+obsidian竟然还能这么用？
Obsidian 到公众号一键发布教程
这套流程适合经常写公众号的人：
在 Obsidian 里完成写作、插图和预览，最后通过插件把整篇文章复制到微信公众号后台。文字格式、标题层级、引用、代码块和本地图片都可以一起带过去，省掉手动排版和逐张上传图片的时间。
整个流程分三步：
- 在 Obsidian 里写稿。
- 在 Obsidian 里插图。
- 用 WeChat Converter 复制到公众号编辑器。
一、准备工具
需要提前准备好这几个东西：
- Obsidian。
- 一个已经打开的 Obsidian 笔记库。
- WeChat Converter 插件仓库地址：
https://github.com/DavidLam-oss/obsidian-wechat-converter
- 微信公众号后台。
WeChat Converter 是一个 Obsidian 微信公众号排版插件，支持 Markdown 转公众号样式、本地图片处理、实时预览、一键复制到公众号，以及配置公众号 API 后同步到草稿箱。
这份教程推荐使用“一键复制到公众号后台”的方式。API 同步草稿箱需要配置公众号 AppID、AppSecret 和相关权限，适合后续进阶使用；日常发布只用复制粘贴，已经足够省事。
二、在 Obsidian 里写公众号文章
Obsidian 的笔记本质上是 Markdown 文件。写公众号时，只要把文章结构写清楚，后续插件就能识别格式。
常用格式如下：
# 一级标题
## 二级标题
这是一段正文。
> 这是一段引用。
- 这是列表
- 这是列表
建议写稿时遵守这几个习惯：
- 标题用
#和##设置，不要手动加粗冒充标题。 - 普通正文直接写自然段，不要额外堆很多空行。
- 重点提醒可以用引用格式
>。 - 图片直接插入到文章对应位置，不要等到公众号后台再补。
- 标题、摘要、封面等发布信息可以提前写在笔记 YAML 表头里，发布前直接复制使用。
示例 YAML 表头：
---
title: 文章标题
summary: 文章摘要
tags:
- 公众号
- Obsidian
status: draft
---
三、在 Obsidian 里插入图片
图片可以直接从本地文件夹拖进 Obsidian 编辑区。插入成功后，正文里会出现一行图片链接。
常见形式有两种：
或：
![[example.png]]
建议把图片统一放进固定附件目录，方便长期管理。比如在 Obsidian 设置里配置：
{
"attachmentFolderPath": "50_Assets/插图",
"newLinkFormat": "relative",
"useMarkdownLinks": true
}
这样以后拖进 Obsidian 的图片会集中进入 50_Assets/插图/，笔记里使用相对路径引用。后续迁移、备份、交付都会更清楚。
图片插入后，先在 Obsidian 阅读视图或右侧预览里确认能正常显示。Obsidian 预览正常，插件复制到公众号时成功率最高。
四、安装 WeChat Converter 插件
WeChat Converter 目前不在 Obsidian 官方社区插件市场里，需要通过 BRAT 安装。
1. 打开社区插件
- 打开 Obsidian。
- 点击左下角齿轮，进入设置。
- 找到“第三方插件”或“社区插件”。
- 如果提示安全模式，先关闭安全模式。
- 点击“浏览”，进入社区插件市场。
2. 安装 BRAT
- 在社区插件市场搜索
BRAT。 - 找到 BRAT 插件。
- 点击“安装”。
- 安装完成后，点击“启用”。
BRAT 的作用是安装还没有进入官方插件市场的 Obsidian 插件。WeChat Converter 就通过它来安装。
3. 通过 BRAT 添加 WeChat Converter
- 回到 Obsidian 设置。
- 在第三方插件列表里找到
BRAT。 - 打开 BRAT 设置页。
- 点击
Add Beta plugin。 - 在输入框里粘贴这个仓库地址：
https://github.com/DavidLam-oss/obsidian-wechat-converter
- 确认添加，等待 BRAT 下载插件。
- 下载完成后，回到“第三方插件”列表。
- 找到
WeChat Converter。 - 点击“启用”。
4. 确认安装成功
安装成功后，Obsidian 左侧工具栏会出现 WeChat Converter 的入口图标。也可以按 Ctrl + P 打开命令面板，搜索：
Open Wechat Converter
执行命令后，右侧会打开公众号预览面板。当前笔记会被转换成公众号排版样式。
五、基础设置建议
打开 WeChat Converter 的插件设置后，先做这几项基础设置：
- 开启“手机仿真框”或类似手机预览模式。
- 选择一套适合自己账号的主题样式。
- 调整字体大小、主题色和两侧留白。
- 打开一篇真实文章，确认标题、正文、引用、图片显示正常。
这些设置调好以后，后续文章会沿用同一套排版风格，不需要每次重新排版。
公众号文章不一定需要复杂样式。多数情况下，标题层级清楚、正文间距舒服、图片能正常显示，就已经够用了。
六、一键复制到公众号后台
稿件确认后，按下面步骤发布：
- 在 Obsidian 打开要发布的文章。
- 打开 WeChat Converter 预览面板。
- 检查标题、正文、引用、列表和图片显示效果。
- 点击插件里的“复制到公众号”按钮。
- 看到复制成功提示后，打开微信公众号后台。
- 新建图文消息。
- 在公众号编辑器正文区域按
Ctrl + V。 - 检查文章格式和图片。
- 填写标题、摘要、封面和合集信息。
- 预览无误后发布或保存草稿。
这个方式的核心好处是：文章主体不需要在公众号后台重新排版。本地写好的 Markdown，会通过插件转换成公众号能识别的富文本格式。
七、关于“一键同步到草稿箱”
WeChat Converter 也支持同步到微信公众号草稿箱，但需要配置公众号开发者信息。
需要准备：
- 公众号 AppID。
- 公众号 AppSecret。
- 公众号后台相关接口权限。
- 插件里的账号配置。
同步成功后，文章会直接进入公众号后台草稿箱。本地图片也会自动处理上传。
新手建议先使用“复制到公众号”方式。它不需要配置 API，不涉及接口权限，也更容易排查问题。等复制粘贴流程稳定后，再考虑配置草稿箱同步。
八、常见问题
1. 找不到 WeChat Converter 插件
确认这几件事：
- BRAT 是否已经启用。
- BRAT 里是否添加了正确仓库地址。
- 仓库地址是否完整：
https://github.com/DavidLam-oss/obsidian-wechat-converter
- 添加完成后是否回到第三方插件列表启用了 WeChat Converter。
2. 插件预览里没有显示当前文章
先点击一下当前笔记正文区域，确保这篇笔记是当前激活文件。然后重新打开 WeChat Converter 面板。
也可以用命令面板执行：
Open Wechat Converter
3. 图片在公众号里没有带过去
优先检查这几项：
- 图片在 Obsidian 预览里是否能正常显示。
- 图片路径是否是有效的本地路径或相对路径。
- 图片文件是否被移动或删除。
- 图片是否过大，尤其是 GIF 动图。
- 图片链接里是否包含奇怪的外部路径或失效路径。
建议把所有正文图片统一放进一个附件目录，再用相对路径引用。
4. 粘贴到公众号后格式不满意
在 WeChat Converter 设置里调整主题、字号、颜色和留白，然后重新复制。公众号后台里的手动调整尽量少做，避免每篇文章风格不统一。
5. 是否必须配置公众号 API
不必须。
只要使用“复制到公众号”功能，就不需要 AppID 和 AppSecret。API 只用于一键同步草稿箱。
九、推荐工作流
稳定使用时，可以按这个顺序操作：
- 在 Obsidian 新建文章模板。
- 在 YAML 表头里写好标题、摘要、标签和状态。
- 用 Markdown 完成正文写作。
- 把图片拖进文章对应位置。
- 打开 WeChat Converter 预览。
- 调整插件主题和排版参数。
- 点击复制到公众号。
- 粘贴到公众号后台。
- 填写封面、标题和摘要。
- 预览并发布。
这套流程真正省掉的是最后的搬运工作。写作仍然需要判断选题、组织材料、打磨观点；插件负责把已经写好的内容稳定搬进公众号后台。
十、插件链接
WeChat Converter GitHub 仓库：
https://github.com/DavidLam-oss/obsidian-wechat-converter
