Obsidian Stats logoObsidian Stats

Jacky-mdflow

by Jackywxsz
5
4
3
2
1
Score: 50/100
Install Code

Description

Obsidian content publishing plugin for WeChat Official Accounts, X Articles, and Xiaohongshu.

Reviews

No reviews yet.

Stats

59
stars
209
downloads
13
forks
34
days
1
days
1
days
0
total PRs
0
open PRs
0
closed PRs
0
merged PRs
0
total issues
0
open issues
0
closed issues
31
commits

Latest Version

1.4.1
2 days ago

Changelog

使用体验更新

  • 将使用指南精简为平台选择、实时预览、微信公众号、X Articles 和小红书五项提示
  • 更新作者介绍：内容营销负责人、AI 自媒体博主、文科生转型 AI FDE 实践者
  • 新增个人频道、全平台同名账号与微信联系方式
  • 移除小红书、公众号、视频号和抖音二维码展示及内嵌二维码资源
  • 精简后的插件包体积更小

兼容性

  • 微信公众号、X Articles 和小红书的排版与导出能力保持不变
  • 最低 Obsidian 版本仍为 1.7.2
See all version on GitHub

README file from

Github

Jacky-mdflow

在 Obsidian 里完成「Markdown 写作 -> 平台预览 -> 一键复制 / 导出」的内容分发插件。

当前支持：

  • 微信公众号：Markdown 转可粘贴的公众号排版 HTML
  • X Articles：长文正文复制 + 图片素材 ZIP
  • 小红书：3:4 图文卡片预览、分页、下载与批量导出

兼容说明：插件 id 和安装目录仍保留 mdflow-publisher，避免影响已经安装的用户；显示名称为 Jacky-mdflow。

English overview

Jacky-mdflow is an Obsidian desktop plugin for turning Markdown notes into publish-ready content for multiple platforms.

  • WeChat Official Accounts: converts Markdown into styled HTML that can be pasted into the WeChat editor.
  • X Articles: copies long-form text with numbered image placeholders and exports the related images as a ZIP archive.
  • RedNote (Xiaohongshu): creates paginated 3:4 content cards and exports individual images or a complete ZIP archive.

The plugin does not require an account, collect telemetry, or upload notes to the author's server. Network requests are only made when a note contains external images that need to be rendered or exported.

当前能力

微信公众号

  • Markdown 转公众号可粘贴 HTML
  • 内置“增强主题”和“经典主题”两组公众号排版主题
  • 增强主题包含摸鱼绿、红白编辑、石墨极简、留白禅意、摸鱼票据、橄榄手记
  • 支持章节自动编号、开头引言、主题化引用/提示/列表/表格/代码块/图片说明
  • 支持 **加粗**、==高亮==、<u>下划线</u>、++下划线++ 等公众号强调语义
  • 预览与复制共用同一份公众号兼容 HTML，减少粘贴后的样式偏差
  • 图片自动转 Base64，复制后可直接粘贴到公众号编辑器
  • 使用 Obsidian 原生 MarkdownRenderer，兼容内部图片、任务列表、嵌入等常见写法

X Articles

  • 生成适合直接粘贴到 X Articles 的长文内容
  • 保留段落、标题、列表等基础结构
  • 自动识别文章图片，在正文里生成 【插入图片 01：文件名】 占位符
  • 导出图片素材 ZIP，方便按占位符顺序上传到 X

小红书

  • 3:4 图文卡片预览与导出
  • 支持 二级标题分页 和 正文卡片流 两种排版模式
  • 二级标题分页：按 ## 拆成不同内容组，适合主题明确的章节卡片
  • 正文卡片流：不按二级标题强制分页，正文连续排满卡片，第一页直接展示内容
  • 仅 Jacky 模板 在 二级标题分页 模式下带封面页
  • 内置默认主题、赛博橙式、赛博薄荷、冷灰橙调等卡片主题
  • 支持模板、字体、字号、头像、封面等设置
  • 支持下载当前页、批量导出全部页 ZIP
  • 自动测量内容高度，尽量减少大面积空白、跳页和内容裁切

安装

Obsidian 第三方插件市场

审核通过后，可在 Obsidian 中打开 设置 -> 第三方插件 -> 浏览，搜索 Jacky-mdflow 并安装。

手动安装

  1. 前往 Releases 下载最新版发布包。
  2. 下载或解压后，把 main.js、styles.css、manifest.json 这 3 个文件放到你的 Vault 插件目录：
.obsidian/plugins/mdflow-publisher/
  1. 重启 Obsidian，或关闭再启用 Jacky-mdflow 插件。
  2. 在 设置 -> 第三方插件 中启用 Jacky-mdflow。

从源码运行

git clone https://github.com/Jackywxsz/Jacky-mdflow.git
cd Jacky-mdflow
npm install
npm run dev

开发模式会把构建产物写入本机配置的 Obsidian 插件目录。直接构建发布包可运行：

npm run build

使用方式

  1. 在 Obsidian 中打开一个 Markdown 文件。
  2. 点击左侧边栏图标，打开右侧 Jacky-mdflow 面板。
  3. 在顶部选择目标平台：微信公众号、X Articles 或小红书。
  4. 根据平台复制或导出。

平台导出方式：

  • 微信公众号：点击复制后，直接粘贴到公众号编辑器。
  • X Articles：复制正文后粘贴到 X，按 【插入图片 xx】 占位符上传导出的图片素材。
  • 小红书：选择模板、排版、字体和字号后，下载当前页或导出全部页 ZIP。

小红书使用说明

小红书有两种排版模式，可以在顶部工具栏的「排版」里切换。

二级标题分页

适合一组卡片围绕不同章节展开。

  • ## 二级标题：作为一个分节标题，也会显示在图片上方
  • --- 分页符：在当前分节内强制换页
  • ### 三级标题：只作为正文小标题，不负责分节
  • 如果没有写 ---，插件会根据内容长度、图片、代码块、列表等自动分页

推荐写法：

## 这是这一组卡片的标题

开头说明文字。

---

![图片](https://raw.githubusercontent.com/jackywxsz/Jacky-mdflow/HEAD/your-image.png)

这一页继续讲图片对应的内容。

### 这是正文子标题

补充说明。

正文卡片流

适合从 Obsidian 笔记直接生成小红书图文。

  • 不会因为每个 ## 都强制换页
  • ##、### 会作为正文里的小标题显示
  • 第一页直接进入正文内容，不额外生成封面
  • 文字会尽量排满当前卡片
  • 遇到较大的图片、表格、代码块或手动 --- 时，会换到下一页

推荐写法：

# 文章标题

第一段直接进入正文。

## 一个正文小标题

继续展开内容，插件会按卡片高度自动分页。

![图片](https://raw.githubusercontent.com/jackywxsz/Jacky-mdflow/HEAD/your-image.png)

图片之后的内容会根据剩余空间继续排版。

X Articles 图片规则

X 不能像公众号一样稳定接收剪贴板里的本地图片，所以插件采用更稳的方式：

  1. 正文复制时保留图片位置，自动写成 【插入图片 01：文件名】。
  2. 同时导出图片素材 ZIP。
  3. 发布到 X Articles 时，按占位符顺序把图片上传到对应位置。

如果图片下载失败，ZIP 里会带 FAILED_IMAGES.txt，可以根据里面的路径手动补图。

更新日志

2026-07-10 / v1.2.0

  • 准备 Obsidian 第三方插件市场发布所需的版本元数据与自动化 Release。
  • 新增官方 Obsidian ESLint 规则检查，并修复插件生命周期、命令名称、设置页标题和预览 DOM 安全问题。
  • 最低支持版本调整为 Obsidian 1.7.2，与实际使用的 API 保持一致。

2026-06-29

  • 小红书新增「排版」选择。
  • 保留原有 二级标题分页 模式，默认行为不变。
  • 新增 正文卡片流 模式，二级标题作为正文小标题，不再强制每个二级标题分页。
  • 正文卡片流 第一页直接展示正文内容，不额外生成封面。

2026-06-27 / v1.1.0

  • X Articles 支持图片占位符和图片素材 ZIP 导出，解决长文里图片难以同步的问题。
  • 修复 X Articles 部分图片被漏掉的问题，导出时会尽量保留本地图片、外链图片和 Base64 图片。
  • 小红书新增 赛博橙式 主题，适配 Jacky 品牌橙色。
  • 小红书移除部分不常用主题，让主题列表更干净。
  • 优化小红书分页和内容测量逻辑，减少跳页、底部大面积空白和内容裁切。
  • 修复小红书切换文章时预览偶发滞后的问题。

2026-05-29

  • 小红书新增 暗橙风格、亮绿风格、冷灰橙调 3 个模板。
  • 暗色模板下载图片时不再变成白底，白色文字可以正常显示。
  • 模板下拉顺序调整为 Jacky 模板、默认主题 优先。
  • 加粗、强调和高亮文字会跟随当前模板的重点色。

已知限制

  • 当前仅支持桌面端 Obsidian，manifest.json 中为 isDesktopOnly: true
  • 小红书自动分页仍然是启发式规则，不是像素级排版引擎
  • 长图、超长代码块、超长表格仍可能需要手动插入 --- 微调
  • 极少数外链图片图床可能不稳定，建议优先使用 Obsidian 本地图片或稳定 CDN
  • 小红书目前更适合图文卡片导出，不是所见即所得设计器

隐私、联网与推广说明

  • 插件不要求登录或付费，不收集遥测数据，也不会把笔记内容上传到作者服务器。
  • 只有当当前笔记包含 http:// 或 https:// 外链图片时，插件才会请求对应图片地址，用于预览、复制或导出；不会请求与当前内容无关的远程服务。
  • 插件默认只读取当前 Obsidian Vault 中的笔记和图片。只有在用户主动选择头像或封面时，才会读取所选图片，并把图片数据保存在该 Vault 的插件配置中。
  • 插件内「关于作者」页面包含作者简介、个人频道、同名社交账号和微信联系方式；README 的「更多资源」包含作者课程链接。这些都是静态信息，不会从远程广告服务动态加载。

更多资源

如果你想系统学习 AI 内容创作、工作流搭建和工具化思路，可以看我的知识库与答疑群介绍：

创作者 AI 课：用 AI 杠杆、代码杠杆、媒体杠杆，重塑内容创作生产体系

开发

npm install
npm run dev
npm run build

如果你想直接部署到本地 Vault：

export OBSIDIAN_VAULT_PATH="/path/to/your/vault"
npm run deploy

技术栈

  • TypeScript
  • Obsidian API
  • Obsidian MarkdownRenderer
  • html-to-image
  • jszip

第三方许可

  • html-to-image — MIT License，Copyright (c) 2017-2025 W.Y.
  • JSZip — 本项目按 MIT License 使用，Copyright (c) 2009-2016 Stuart Knightley、David Duponchel、Franz Buchinger、António Afonso。

License

Jacky-mdflow 的代码以 GNU Affero General Public License v3.0 授权。

Sponsors