Tip
让 Obsidian 成为你的内容创作与发布工作台。
写作留在 Obsidian，设计、排版与发布交给 NoteToMP。
从 Markdown 写作，到主题排版、样式小部件、图片处理，再到微信公众号素材、草稿发布和自动化工作流，一套流程完成内容生产。
写作 → 设计 → 排版 → 配图 → 发布 → 自动化
还在用微信公众号自带的编辑器写文章吗？五分钟写完内容，半小时调格式，调完了还是哪里不对劲。还在为了让文章好看一点，充值会员买那些花里胡哨的排版素材吗？调来调去不仅费时间，还费钱。
试试 Obsidian + NoteToMP 的组合。
你在 Obsidian 里正常写 Markdown，该怎么记笔记就怎么写——这份笔记本身就是你的知识库，不是专门为了发公众号才写的一次性内容。写完之后，从 30+ 款精心设计的主题里选一个钟意的，一键排版、一键发草稿，格式、图片、代码高亮、数学公式统统安排妥当。
效率上，原来要手动调半小时的格式，现在几秒钟搞定;素材上，不需要另外充值购买花哨模板，主题和样式小部件全都内置;数据上，你的每一篇文章依然是 Obsidian 仓库里一个普通的 Markdown 文件，存在你自己的电脑里，不依赖任何平台账号，换电脑、换插件都带得走。
笔记是你自己的资产，写作和发布本该是同一件事的两个自然结果——而不是两倍的工作量。
很多"发公众号"的工具，本质上是让你迁就工具的语法——为了排版效果，笔记里塞满了平台专属的标记，离开这个工具，笔记就不完整了。
NoteToMP 反过来做：笔记怎么写，完全由 Obsidian 原生语法决定，NoteToMP 只负责在发布时把它渲染成一篇完整的公众号文章。 也就是说，你不需要为了"能发公众号"而改变记笔记的方式，该怎么记就怎么记。
具体来说，NoteToMP 完整支持以下 Obsidian 原生语法，基本覆盖日常写作会用到的所有格式：
- 基础排版：标题、段落、列表(有序/无序/任务列表)、引用、分隔线、脚注
- 富文本元素：Callout(提示框)、表格、代码块(带语法高亮)
- 多媒体与嵌入：图片、GIF、SVG、WikiLink 文件嵌入(引用其他笔记的整篇或某一章节、某一段落)
- 数学公式：LaTeX、AsciiMath，支持行内公式与行间公式，自动渲染为适配公众号的 SVG(详见内容处理)
- 图表与手绘：Mermaid 流程图、时序图、甘特图等可以直接渲染成图片;Excalidraw 手绘白板笔记也能原样带入文章，不需要额外截图或导出
换句话说，无论你的笔记里有没有一段 Mermaid 流程图、一个 Excalidraw 草图，还是一堆 LaTeX 公式，这篇笔记本身在 Obsidian 里就是可以正常阅读、正常使用的——它首先是一篇完整的笔记，其次才是一篇待发布的公众号文章。
NoteToMP 提供 30+ 款排版主题，可以快速为文章选择完整的视觉风格，统一控制字体、标题、正文、引用、列表、表格、图片、Callout、代码块、背景与间距。选择一个主题，就可以直接开始写作。
如果你有自己的设计风格，也可以使用**自定义主题、CSS 和 LESS(推荐)**完全控制文章样式：
.note-to-mp {
font-family: Optima， "Microsoft YaHei"， PingFangSC-Regular， serif;
}
.note-to-mp h2 {
color: #5ab983;
}启用「自定义」主题后，可以完全使用自己的样式，不再受默认主题影响。对于熟悉 CSS / LESS 的用户，NoteToMP 可以作为一个高度可定制的 Markdown → 微信 HTML 渲染工具。也可以通过 note-to-mp-theme-creator 这个 SKILL 轻松定制自己的文章主题。
普通 Markdown 中，同一种标题通常只能拥有统一的样式。但一篇精心设计的公众号文章，往往需要数字标题、特殊标题、提示卡片、推荐文章、图片卡片、内容强调、特殊分隔等更丰富的局部设计——这就是样式小部件解决的问题。
样式小部件允许你对文章中的标题、段落、图片、推荐内容等局部内容使用独立的视觉组件，每个组件用独立 ID 标识，例如 #1008、#4001。
一键插入： 打开命令面板(Ctrl/Cmd + P)→ 搜索「插入样式小部件」→ 选择需要的组件，NoteToMP 会自动插入完整语法，你只需修改内容，不需要记忆复杂语法。
> [#1008] 01复杂一点的文章推荐组件：
> [#4001] 文章推荐
> > ### 2026-09-06
> > [文章标题](https://example.com)
> > ![[文章封面.jpg]]flowchart LR
A[Markdown] --> C((+))
B[样式小部件] --> C
C --> D[更丰富的内容设计]
Markdown 负责内容，小部件负责局部设计。
样式小部件语法比较特殊，若直接写在笔记里会影响正常的版式。为此 NoteToMP 提供了专家设置——一套基于 YAML 的深度配置能力，不只是"高级 CSS 设置"，而是可以自定义整个渲染过程：
render:
h2: 1038
code: 5001
callout:
note: 6130
frontmatter:
title: title
author: author
cover: cover这样你平时只需要正常写 Obsidian 原生语法(二级标题、Callout、代码块……)，发布时 NoteToMP 会按配置自动转换为指定的小部件。也就是说：
你可以继续使用 Obsidian 原生语法写作，而让 NoteToMP 在发布阶段完成复杂的视觉设计。
专家设置还支持自定义标题 HTML，以及文档属性重映射，可以适配不同用户自己的笔记体系(详见下方多公众号一节)。
⚠️ 专家设置属于高级功能。如果配置错误可能导致渲染异常，请在充分理解配置规则后再使用。
图片往往是 Markdown → 微信公众号过程中最麻烦的一环。NoteToMP 可以处理文章中的本地图片，并在发布过程中完成图片上传和地址处理，支持 Obsidian WikiLink 图片、本地图片、GIF、SVG，以及图片尺寸、背景、圆角、阴影、边框、渐变、水印等效果。
支持 Obsidian 原生图片尺寸语法：
![[image.jpg|480]] # 指定宽度，高度按比例缩放
![[image.jpg|480x360]] # 同时指定宽度和高度对于需要更精致视觉效果的文章，可以通过 Ctrl/Cmd + P → 图片背景设置 为图片增加统一的渐变背景、纯色背景、边框、圆角、阴影、水印，也可以针对某一篇文章临时关闭图片背景。
NoteToMP 针对微信公众号环境对数学公式进行了专门处理，支持 LaTeX、AsciiMath、行内公式与行间公式，并会将公式转换为适合公众号环境的 SVG。
$c=\pm\sqrt{a^2+b^2}$ 行内公式
$$
c=\pm\sqrt{a^2+b^2} 行间公式
$$也可以通过代码块明确指定公式类型：
```latex
c=\pm\sqrt{a^2+b^2}
```
```am
c=+-sqrt(a^2+b^2)
```
Obsidian 的文件嵌入同样可以用于公众号创作，将以前文章中的某一章节、某个段落直接引用到当前文章：
![[文件名称#章节标题]]
![[文件名称#^段落标记]]非常适合引用以前的文章、复用知识库内容、制作文章模板、构建系列文章。这意味着：
你的 Obsidian 知识库本身，也可以成为公众号内容素材库。
完成排版后，有两种发布方式：
flowchart LR
A[NoteToMP] -->|复制| B[微信公众号编辑器] -->|粘贴| C[发布完成]
A -->|发草稿| D[微信公众号草稿箱] -->|后台检查| C
选择「复制」无需重新调整标题、字体、图片和代码样式;选择「发草稿」，NoteToMP 会处理文章中的图片并直接发送到公众号草稿箱，你仍可在正式发布前进入公众号后台做最后检查。
NoteToMP 不直接替你发布文章，而是将文章安全地发送到公众号草稿箱。
如果你同时运营多个公众号，可以在 NoteToMP 中配置多个公众号，并在发布时进行选择。文章的发布配置也可以通过文档属性(frontmatter)保存，把文章内容 + 发布配置 + 排版配置一起存在 Markdown 文件里：
---
标题:
作者:
封面:
摘要:
封面素材ID:
封面裁剪: false
原文地址:
打开评论: true
仅粉丝可评论: false
公众号:
样式:
自定义样式笔记:
禁用图片背景: false
---如果你的笔记体系使用不同的属性名称，可以通过专家设置中的文档属性重映射进行适配。
- 素材管理：2.4.0 起支持公众号素材管理，通过命令面板「公众号内容管理」进入，可以把文章、图片、封面等内容逐渐纳入统一的内容生产流程，让 NoteToMP 成为 Obsidian 与微信公众号内容资产之间的连接层。
- Unsplash 封面：2.4.0 起支持发布时直接使用 Unsplash 图片作为文章封面，不需要每次单独寻找和下载封面图。
除了公众号文章，NoteToMP(2.3.0 起)还可以直接将 Obsidian 笔记转换成图片，适用于公众号贴图、小红书图片、知识卡片、教程长图、社交媒体内容等场景。可设置图片尺寸、字体、边距、背景，导出图片或直接发布为公众号贴图。
一篇 Obsidian 笔记可以进一步用于其他内容平台。目前已支持或提供相关发布能力：微信公众号、微信公众号贴图、小红书图片、𝕏 长文章、知乎、今日头条等(部分平台需配合其他工具或浏览器插件使用，具体以对应功能说明为准)。2.0.0 起已加入知乎、头条、小红书等平台支持，以及多篇笔记合并、批量发布能力。
NoteToMP 可以与 n8n、Coze 等工作流平台连接，让文章发布过程成为自动化工作流的一部分：
flowchart TD
A[Obsidian<br/>写作] --> B
subgraph B["NoteToMP"]
direction TB
C[发布前] --> C1[AI 优化标题] & C2[AI 生成摘要] & C3[内容检查]
C1 --> D[发布]
C2 --> D
C3 --> D
D --> E[发布后] --> E1[自动执行其他任务]
end
B --> F[微信公众号]
支持：AI 自动生成内容、发布前/发布后执行工作流、手动运行工作流、从笔记属性读取参数、从仓库读取笔记与图片。
url: https://example.com/workflow
runAt: start
method: POST还可以直接将当前笔记属性、其他笔记内容以及图片作为工作流参数，在执行时动态解析：
parameters:
author: $author
content: ![[提示词]]
image: ![[cover.jpg]]自动化工作流调用微信公众号 API 通常需要处理 AppSecret，直接放进工作流存在安全风险。NoteToMP 提供专用接口获取 AccessToken：工作流无需暴露 AppSecret、不需要固定服务器 IP、使用更简单，更适合自动化场景(会员功能)。
得益于 Obsidian CLI，现在可以通过 note-pub-skill 这个 SKILL，在各类 AGENT 中直接调用 NoteToMP 插件排版并发布文章到公众号。
Obsidian → 设置 → 第三方插件 → 社区插件 → 搜索 NoteToMP → 安装并启用。
首次安装后如果没有显示完整主题，可进入 设置 → 第三方插件 → NoteToMP → 获取更多主题 下载。
如果使用 GitHub Release 安装，也可以下载 assets.zip，解压到 .obsidian/plugins/note-to-mp/assets，目录结构应类似：
note-to-mp/
├── assets/
│ ├── themes.json
│ ├── highlights.json
│ ├── themes/
│ └── highlights/
├── main.js
├── manifest.json
└── styles.css
打开命令面板(Ctrl/Cmd + P)→ 搜索「复制到公众号」→ 在预览界面选择喜欢的主题(常用主题可在插件设置中设为默认)→ 选择「复制」或「发草稿」完成发布。
如果遇到问题或者有功能建议，欢迎通过 GitHub Issue 反馈，也欢迎加入用户交流群。