字节笔记本

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 R2Cloudflare 对象存储服务
又拍云又拍云存储服务
TelegramTelegram 图床
CloudinaryCloudinary 图片管理
自定义上传支持自定义上传接口

安装指南

方式一:使用 npm CLI(推荐)

bash
# 全局安装
npm i -g @doocs/md-cli

# 启动服务(默认端口 8800)
md-cli

# 访问编辑器
open http://127.0.0.1:8800

# 指定端口启动
md-cli port=8899

CLI 支持参数:

  • 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/

快速开始

基础用法

  1. 打开编辑器(在线版或本地部署)
  2. 在左侧编辑区输入 Markdown 内容
  3. 右侧实时预览渲染效果
  4. 点击「复制」按钮获取微信图文格式
  5. 粘贴到微信公众号编辑器

自定义主题

css
/* 在自定义 CSS 区域添加 */
.custom-theme {
  --primary-color: #07c160;
  --font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto;
}

使用 AI 助手

  1. 点击右上角 AI 助手图标
  2. 选择 AI 提供商(DeepSeek/OpenAI/通义千问等)
  3. 配置 API Key
  4. 使用 AI 辅助写作、润色、翻译等功能

部署选项

部署在 /md 目录

bash
pnpm web build

部署在根目录

bash
pnpm web build:h5-netlify

Chrome 插件

bash
# 开发模式
pnpm web ext:dev

# 打包
pnpm web ext:zip

安装方式:访问 chrome://extensions/,打开开发者模式,加载已解压的扩展程序。

Firefox 扩展

bash
pnpm web firefox:zip
# 输出文件:apps/web/.output/md-{version}-firefox.zip

uTools 插件

bash
pnpm utools:package
# 输出文件:apps/utools/release/md-utools-v{version}.zip

Cloudflare Workers

bash
# 开发模式
pnpm web wrangler:dev

# 部署
pnpm web wrangler:deploy

项目链接

总结

doocs/md 是一款功能完善、体验优秀的微信 Markdown 编辑器。无论是个人博客写作、技术文档编写,还是公众号运营,都能显著提升排版效率。丰富的图床支持、AI 助手集成、多平台部署能力,使其成为内容创作者的得力工具。项目完全开源免费,社区活跃,值得尝试和使用。

分享: