Note Publisher使用手册

1、简介

Note Publisher 是一个 Obsidian 插件，核心功能是将笔记渲染为微信公众号编辑器兼容的 HTML 格式，同时支持发布到 微信公众号、WordPress等多个平台，实现一处编辑多处分发，极大降低多个内容平台运营和维护的工作量。

主要功能

• 微信公众号发布：复制 HTML 到编辑器、上传图片到素材库、发布草稿、图文消息；

• WordPress 发布：支持渲染 HTML 和原文两种模式，多站点管理；

• 丰富的样式系统：30+ 主题、60+ 代码高亮样式、自定义 CSS；

• 完整的 Markdown 支持：代码高亮（含行号）、数学公式（LaTeX / AsciiMath）、Callout、文本高亮、文件嵌入、Mermaid 图表；

• Excalidraw 本地渲染：将 .excalidraw.md 文件渲染为 SVG 图片；

• 图片处理：本地图片上传、图床图片处理、WebP 转 JPG、封面图裁剪；

2、安装

首先，请确认已关闭了 Obsidian 的安全模式。如未关闭，请通过 设置 — 第三方插件 — 关闭安全模式 关闭。

2.1 插件安装

1）从产品官方主页下在

在 https://xsoft.cc/notepublisher 网页上，点击【下载Note Publisher】连接，下载插件。

2）从网盘下载安装

下载其中的 note-publisher-xxxx.zip，解压后，将其中的 notepublisher 目录拖到 .obsidian/plugins 目录下。

打开 Obsidian 的 设置 界面，点击 第三方插件，在 已安装插件 中刷新一下，然后启用本插件。

2.2 主题资源安装

在产品官方主页下载和网盘下载的插件，安装包已经集成了主题样式，无需下载。

您可以参考插件目录(notepublisher/assets/themes/)下的CSS文件，自己创建自己的主题风格。

后续在https://xsoft.cc/notepublisher上会陆续分享主题，敬请期待。

2.3 常见安装问题

⚠️ 插件的目录名必须是：notepublisher，出现安装问题时请先检查目录名是否正确。

1）插件无法启动

检查插件目录结构是否正确：

.obsidian/plugins/note-publisher/

├── assets/

│ ├── themes.json

│ ├── highlights.json

│ ├── themes/

│ │ ├── maple.css

│ │ ├── mweb-ayu.css

│ │ └── ...

│ └── highlights/

│ ├── a11y-dark.css

│ ├── a11y-light.css

│ └── ...

├── main.js

├── manifest.json

└── styles.css

2）只有默认主题

确认已按 2.2 主题资源安装 步骤操作，到插件主题目录查看是否有相关主题样式文件。

插件目录结构应如下：

.obsidian/plugins/note-publisher/

├── assets/

│ ├── themes.json

│ ├── highlights.json

│ ├── themes/

│ │ ├── maple.css

│ │ ├── mweb-ayu.css

│ │ └── ...

│ └── highlights/

│ ├── a11y-dark.css

│ ├── a11y-light.css

│ └── ...

├── main.js

├── manifest.json

└── styles.css

3、使用

点击 Obsidian 左侧工具栏中的图标，或按 Ctrl+P 打开命令面板，搜索 Note Publisher。

在预览界面选择样式和代码高亮主题，确认渲染效果无误后，选择【发布平台】，选择对应的发布账号，点击 【发布到微信】或【发布到Wordpress】按钮，选择对应的发布方式。

3.1 发布到微信公众号

点击【发布到微信公众号】按钮后，在弹窗中选择发布方式：

支持多公众号切换，在预览界面下拉菜单中选择目标公众号。

3.2 发布到 WordPress

选择 WordPress 平台后，可以选择已配置的站点，支持：

• 渲染 HTML 模式（默认）：使用预览界面的渲染结果，包含样式和代码高亮

• 原文模式：发送原始 Markdown，由 WordPress 端渲染

在弹出发布界面，设置发布状态、评论状态、分类和标签。

4、Markdown 扩展语法

4.1 数学公式

支持 LaTeX 和 AsciiMath 两种语法，可在插件设置中切换默认语法。

行内公式：$c=\pm\sqrt{a^2+b^2}$

  

行间公式：

$$

c=\pm\sqrt{a^2+b^2}

$$

使用代码块可以明确指定公式语法（仅适用于行间公式）：

采用 LaTeX 语法：

```latex

c=\pm\sqrt{a^2+b^2}

```

  

采用 AsciiMath 语法：

```am

c=+-sqrt(a^2+b^2)

```

参考资源：

• LaTeX 使用指南：从入门到精通 – 少数派[https://sspai.com/post/77684]

• 通用 LaTeX 数学公式语法手册[http://www.uinio.com/Math/LaTex/]

• AsciiMath Parser[https://asciimath.widcard.win/zh/introduction/]

• AsciiMath 官网[https://asciimath.org/]

提示：AsciiMath 相对简单，适合不熟悉 LaTeX 的用户现学现用。但需注意 AsciiMath 不支持在一个语法块中写多行公式，多行公式需每行单独写一个语法块。

4.2 Mermaid 图表

使用 mermaid 代码块绘制流程图、时序图等：

```mermaid

graph LR

A[开始] --> B{条件}

B -->|是| C[执行]

B -->|否| D[结束]

```

Mermaid 图表会渲染为 PNG 图片嵌入到文章中。

4.3 Excalidraw 绘图

插件支持本地渲染 Excalidraw 文件，将 .excalidraw.md 转换为 SVG 图片：

![[绘图.excalidraw]]

![[绘图.excalidraw.md|400]]

![[绘图.excalidraw.md|400x300|center]]

支持设置尺寸和对齐方式（left / center / right）。

4.4 图片尺寸

使用 Obsidian 语法设置图片大小：

![[image.jpg|120x80]] 设置宽度和高度

![[image.jpg|120]] 设置宽度，高度按比例缩放

4.5 文件嵌入

引用其他笔记的内容，支持章节和段落标记：

![[文件名称#章节标题]]

![[文件名称#^段落标记]]

在插件设置中可选择两种展示样式：

• 引用：Obsidian 默认的引用框样式

• 正文：直接渲染为正文内容（类似模板）

4.6 Callout

支持 Obsidian Callout 语法，包括 note、abstract、tip、success、question、warning、failure、danger、example、quote 等类型。

> [!note] 标题

> 这是 Note 类型的 Callout

>

> [!warning]

> 这是 Warning 类型的 Callout

4.7 公众号卡片

公众号卡片内容需要从已发布的文章中获取。在公众号中回复”卡片”，获取链接后输入包含公众号卡片的文章链接，点击获取即可获得卡片代码，复制粘贴到 Obsidian 笔记中即可。

详细操作视频：https://www.bilibili.com/video/BV1rPW7eqEUH/

4.8 SVG 图标

支持在笔记中插入 SVG 图标文件。

视频教程：https://www.bilibili.com/video/BV15XWVeEEJa/

5、插件设置

通用设置

微信设置

配置公众号信息（AppID、Secret），支持加密保存、测试连接。

WordPress 设置

7、反馈与交流

微信群：加微信 HZWX9001，备注 NotePublisher