MDX Notes：公众号排版与 MDX 笔记工具

项目简介

MDX Notes 是一款跨平台笔记软件，同时也是一个微信公众号排版编辑器。官方网站：https://mdxnotes.com/ 。

项目灵感来自 mdxjs playground：Markdown 是很多程序员喜爱的写作格式，但难以满足微信公众号的排版需求，而 MDX 正好可以弥补 Markdown 在排版上的不足。作者希望用 MDX 把写作和排版统一起来。

主要功能

网页版

• 一键复制内容到微信公众号
• 自定义样式组件与样式，生成二维码、代码 diff 高亮
• 自动生成文章目录
• 方便地制作微信脚注
• 自动把微信公众号的外部链接转换成 span 元素
• 保证代码格式准确
• 内置文章分享功能
• 下载 Markdown 文件
• 导出 PDF

桌面版

在网页版功能之外，桌面版还提供：

• 本地文件实时保存
• 本地文件目录管理
• HTML 导出

README 中给出了多套模板示例，例如「Subtle Green Card」「Early Summer Style」「Resume Template」「Exquisite Code Diff Highlights」「Generate Captivating QR Codes」「Travel Itinerary」，可在官网文章页查看效果。

安装与使用

直接使用网页版

打开 https://mdxnotes.com/ 即可开始写作与排版。

下载桌面版

安装包在 Releases 页面提供，按平台选择：

• macOS：Intel 芯片选 x64.dmg，Apple M 芯片选 aarch64.dmg
• Windows：64 位选 x64-setup.exe
• Linux：64 位选 amd64.deb

如果需要检查渲染样式，可以下载 debug 版本。

本地开发

网页版切换到 main 分支后执行：

yarn
yarn dev

桌面版切换到 tauri-app 分支后执行：

yarn
yarn tauri dev

注意事项

MDX Notes 未做签名，在 macOS 上安装后可能提示「文件已损坏」或打开无响应，这是系统的安全检查拦截所致。

设置中信任开发者（会要求输入密码）：

sudo spctl --master-disable

然后放行 MDX Notes：

xattr -cr /Applications/MDX\ Notes.app

如果提示 option -r not recognized，改用：

xattr -c /Applications/MDX\ Notes.app/*

若以上仍无效，可尝试：

sudo xattr -d com.apple.quarantine /Applications/MDX\ Notes.app/

项目基于 Next.js 构建，官网使用 Vercel 部署，采用 GPL-3.0 许可证。

---

本作品整理自 GitHub 开源项目 maqi1520/mdx-notes，原作者 @maqi1520，许可证 GPL-3.0。中文介绍由 AI 根据项目 README 整理，以原仓库为准。