字
字节笔记本
2026年2月23日
doocs/md:微信 Markdown 编辑器 - 让排版更高效
本文介绍 doocs/md,一款专为微信公众号排版设计的 Markdown 编辑器。该项目在 GitHub 上已获得超过 11.8k stars,支持多种图床、自定义主题、AI 助手等高级功能,帮助内容创作者高效产出精美图文。
项目简介
doocs/md 是由 Doocs 社区开发维护的开源项目,全称为「微信 Markdown 编辑器」。它解决了现有工具样式繁杂、排版效率低的问题,让写作者可以专注于内容创作,同时获得专业级的微信图文排版效果。
该项目采用 Vue 3 + TypeScript + Vite 技术栈构建,代码质量高,社区活跃,拥有 48 位贡献者。项目遵循 WTFPL 许可证,可自由使用和修改。
核心特性
基础功能
- 完整 Markdown 支持:标准 Markdown 语法全兼容
- 数学公式渲染:支持 LaTeX 数学公式,适合技术文章
- Mermaid 图表:流程图、时序图、甘特图等可视化图表
- GFM 警告块:支持 GitHub 风格的警告/提示框
- PlantUML 支持:UML 图表绘制
- Ruby 注音:中文拼音标注支持
编辑体验
- 代码高亮:多种编程语言语法高亮
- 自定义主题:支持自定义主题色和 CSS 样式
- 草稿自动保存:防止意外丢失编辑内容
- 实时预览:所见即所得的编辑体验
高级功能
- 多图床支持:支持 13 种图床服务,灵活选择
- 文件导入导出:支持 Markdown 文件导入和多种格式导出
- AI 集成:内置 DeepSeek、OpenAI、通义千问等 AI 助手
- 多平台部署:支持 Web、Chrome 插件、uTools 插件、Firefox 扩展
技术栈
- Vue 3:渐进式 JavaScript 框架
- TypeScript:类型安全的 JavaScript 超集
- Vite:下一代前端构建工具
- Tailwind CSS:实用优先的 CSS 框架
- Pinia:Vue 状态管理方案
支持的图床服务
| 图床类型 | 说明 |
|---|---|
| 默认图床 | 项目提供的默认图床服务 |
| GitHub | 使用 GitHub 仓库作为图床 |
| 阿里云 OSS | 阿里云对象存储服务 |
| 腾讯云 COS | 腾讯云对象存储服务 |
| 七牛云 Kodo | 七牛云对象存储 |
| MinIO | 自建 MinIO 对象存储 |
| S3 协议 | 兼容 AWS/Oracle/DigitalOcean 等 S3 服务 |
| 公众号图床 | 直接使用微信公众号图床 |
| Cloudflare R2 | Cloudflare 对象存储服务 |
| 又拍云 | 又拍云存储服务 |
| Telegram | Telegram 图床 |
| Cloudinary | Cloudinary 图片管理 |
| 自定义上传 | 支持自定义上传接口 |
安装指南
方式一:使用 npm CLI(推荐)
bash
# 全局安装
npm i -g @doocs/md-cli
# 启动服务(默认端口 8800)
md-cli
# 访问编辑器
open http://127.0.0.1:8800
# 指定端口启动
md-cli port=8899CLI 支持参数:
port:指定服务端口config:指定配置文件路径
方式二:使用 Docker
bash
# 运行容器
docker run -d -p 8080:80 doocs/md:latest
# 访问 http://localhost:8080方式三:本地开发
bash
# 克隆仓库
git clone https://github.com/doocs/md.git
cd md
# 安装 node 版本
nvm i && nvm use
# 安装依赖
pnpm i
# 启动开发服务器
pnpm web dev
# 访问 http://localhost:5173/md/快速开始
基础用法
- 打开编辑器(在线版或本地部署)
- 在左侧编辑区输入 Markdown 内容
- 右侧实时预览渲染效果
- 点击「复制」按钮获取微信图文格式
- 粘贴到微信公众号编辑器
自定义主题
css
/* 在自定义 CSS 区域添加 */
.custom-theme {
--primary-color: #07c160;
--font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto;
}使用 AI 助手
- 点击右上角 AI 助手图标
- 选择 AI 提供商(DeepSeek/OpenAI/通义千问等)
- 配置 API Key
- 使用 AI 辅助写作、润色、翻译等功能
部署选项
部署在 /md 目录
bash
pnpm web build部署在根目录
bash
pnpm web build:h5-netlifyChrome 插件
bash
# 开发模式
pnpm web ext:dev
# 打包
pnpm web ext:zip安装方式:访问 chrome://extensions/,打开开发者模式,加载已解压的扩展程序。
Firefox 扩展
bash
pnpm web firefox:zip
# 输出文件:apps/web/.output/md-{version}-firefox.zipuTools 插件
bash
pnpm utools:package
# 输出文件:apps/utools/release/md-utools-v{version}.zipCloudflare Workers
bash
# 开发模式
pnpm web wrangler:dev
# 部署
pnpm web wrangler:deploy项目链接
- GitHub 仓库:https://github.com/doocs/md
- 在线编辑器:https://md.doocs.org
- npm 包:https://www.npmjs.com/package/@doocs/md-cli
- Docker Hub:https://hub.docker.com/r/doocs/md
- 使用教程:https://md-pages.doocs.org/tutorial
总结
doocs/md 是一款功能完善、体验优秀的微信 Markdown 编辑器。无论是个人博客写作、技术文档编写,还是公众号运营,都能显著提升排版效率。丰富的图床支持、AI 助手集成、多平台部署能力,使其成为内容创作者的得力工具。项目完全开源免费,社区活跃,值得尝试和使用。
分享: