灿海星图指南--12.9K星的公众号排版神器，一行npm命令，AI帮你写帮你排
写了一篇公众号文章，调格式调了一个小时——列表缩进不对、代码块换行乱了、引用样式和正文一样。如果你每次发公众号都花一半时间在排版上，这个工具是给你准备的。
本文是一篇实操指南，预计10分钟完成全部操作。
这是什么
Doocs/md是一个微信Markdown编辑器，12.9K星。左边写Markdown，右边实时渲染成微信图文样式。写完了复制到公众号后台直接发布。
能做什么：Markdown转微信图文、数学公式（KaTeX）、Mermaid图表、AI辅助写作（接DeepSeek等主流模型）、自定义CSS主题、多图床自动上传。
在线版免费：https://md.doocs.org
适用： 经常写公众号、需要Markdown排版、不想手动调格式的人。 不适用： 只发朋友圈的人（不需要这个）。
三种使用方式
方式一：在线版（零安装）
打开 https://md.doocs.org ，直接写。本地草稿自动保存。适合偶尔写一篇。
方式二：npm CLI
npm i -g @doocs/md-cli
md-cli
访问 http://localhost:8800。数据在本地，离线可用。
方式三：Docker
docker run -d -p 8080:80 doocs/md:latest
适合团队共用一个实例，统一主题和配置。
核心功能
标准Markdown转微信图文。 支持标题层级、加粗斜体、列表、引用、代码块、表格、链接、图片。公式用KaTeX渲染，Mermaid图表直接渲染。
AI辅助写作。 接入主流大模型API后，编辑器内置AI助手。写大纲、改写段落、润色标题都在编辑器里完成，不用切工具。
自定义主题。 内置多套CSS主题。不同公众号可以配不同主题。
多图床。 支持12种图床：GitHub、阿里云OSS、腾讯云COS、七牛云、MinIO、S3、Cloudflare R2等。
踩坑实录
| 现象 | 原因 | 解决 |
|---|---|---|
| Chrome扩展版看不到网页版草稿 | 网页版和扩展版用独立本地存储，数据不互通 | 固定用一端写作，或Docker版统一存储 |
| Mermaid图表在手机端偏小 | 默认SVG宽度不适应手机屏幕 | 自定义CSS加 .mermaid svg { min-width: 100% } |
| 代码块换行在手机上错乱 | 微信渲染引擎对 <pre> 标签支持不一致 | 代码块内手动换行，长行控制在40字符内 |
常见疑问
Q1：AI辅助写作需要自己的API Key吗？
需要。工具不附带模型额度，在设置里填入兼容OpenAI接口的API Key和地址。用灿海星图、DeepSeek官方Key等都可以，按实际token用量计费。
Q2：网页版和npm本地版有什么区别？
网页版数据在浏览器本地存储，换设备看不到。npm版数据在电脑磁盘上，离线可用。Docker版适合团队共享。功能上三者几乎一样。
Q3：Mermaid图表导出到公众号后正常吗？
大部分正常，但手机端部分图表字号偏小。在自定义CSS里加 .mermaid svg { min-width: 100% } 可解决。复杂图表建议先在桌面端公众号预览确认。
本文数据来源于GitHub仓库（Doocs/md）及作者实测。