md

用 Markdown 写微信文章，一键排版，告别繁琐样式调整

md 是一款基于 TypeScript 开发的高度简洁的微信 Markdown 编辑器，主要面向微信公众号运营者、技术写作者等需要频繁排版微信文章的用户。它解决了微信原生编辑器排版繁琐、样式不统一、代码块支持差等痛点，让用户可以直接用 Markdown 语法写作，并通过内置的多种主题样式一键美化排版。核心能力包括：实时预览和复制到微信公众号后台，支持自定义 CSS 主题、内容管理（保存多篇文章草稿）、多图床接入（如阿里云 OSS、腾讯云 COS 等），以及 AI 助手辅助写作和润色。编辑器界面干净，操作流畅，支持键盘快捷键，适合快速产出格式规范的微信图文。项目在 GitHub 上拥有超过 1.3 万星标，社区活跃，持续迭代，是微信生态内较为成熟的 Markdown 编辑工具之一。

开源 free 开源模型

访问官网 ↗ GitHub ↗ 文档 ↗

GitHub 星标 ★ 13364

维护状态活跃

是否开源是

定价模式 free

项目数据

分类开源模型

开发团队doocs

所属国家

官网地址https://md.doocs.org

GitHubhttps://github.com/doocs/md

定价模式free

价格说明开源项目，完全免费，无付费版本。

访问状态

是否开源是

开源协议WTFPL

主要语言TypeScript

技术栈/模型ai-bot,doocs,editor,llm,markdown,markdown-editor,tailwindcss,vite,vue,vue3,wechat,weixin

GitHub 星标★ 13364

30天Star增速

HF 下载量

上线时间2019-11-01 00:00:00

最近更新2026-09-22 00:00:00

维护状态活跃

中文支持

访问方式

移动端支持

综合评分

收录时间2026-08-09

浏览次数6

使用教程

难度：进阶约 15 分钟部署方式：本地安装 8 步

环境要求

Node.js 环境（README 使用 nvm 安装与切换版本）
pnpm 包管理工具
Docker（可选，用于容器化部署）
推荐使用 Chrome 浏览器获得最佳体验

安装与启动步骤

1安装 Node 版本

用 nvm 安装并使用项目指定的 Node 版本，未安装 nvm 需先自行准备。
```
nvm i && nvm use
```
2安装项目依赖

在仓库根目录安装全部依赖，需先克隆项目并进入目录。
```
pnpm i
```
3启动开发模式

启动本地开发服务，启动后浏览器访问 http://localhost:5173/md/ 即可使用编辑器。
```
pnpm web dev
```
4构建生产产物

部署在 /md 路径下用 build，部署在根路径下用 build:h5-netlify，二者按需选择。
```
pnpm web build
pnpm web build:h5-netlify
```
5开发浏览器扩展

在 chrome://extensions/ 开启开发者模式，加载 apps/web/.output/chrome-mv3-dev 目录。
```
pnpm web ext:dev
```
6部署到 Cloudflare

分别用于 Cloudflare Workers 的本地开发预览与线上部署。
```
pnpm web wrangler:dev
pnpm web wrangler:deploy
```
7CLI 私有化部署

全局安装 @doocs/md-cli 后执行 md-cli 启动，默认监听 8800 端口。
```
npm i -g @doocs/md-cli
md-cli
```
8Docker 一键部署

用官方镜像启动容器并映射 8080 端口，镜像详情见 doocs/docker-md 仓库。
```
docker run -d -p 8080:80 doocs/md:latest
```

关键配置

配置项	必填	说明	示例
`port`	否	md-cli 监听端口，默认 8800，被占用时自动随机选取。	`md-cli port=8899`
`spaceId`	否	dcloud 服务空间配置，私有化部署时可传。	`spaceId=your-space-id`
`clientSecret`	否	dcloud 服务空间配置，私有化部署时可传。	`clientSecret=your-client-secret`

如何确认成功

浏览器访问 http://localhost:5173/md/，或 Docker 部署后访问 http://localhost:8080，能打开编辑器并即时预览 Markdown 即成功。

常见问题

Q：md-cli 启动时端口被占用怎么办？

A：默认使用 8800 端口，被占用时会自动随机选取一个可用端口；也可用 md-cli port=8899 手动指定端口。

Q：开发模式构建产物部署路径有什么区别？

A：pnpm web build 构建的产物部署在 /md 路径下；pnpm web build:h5-netlify 构建的产物部署在根路径下。

Q：不想本地部署可以直接用吗？

A：可以，官方提供在线编辑器 https://md.doocs.org，推荐使用 Chrome 浏览器以获得最佳体验。

Q：浏览器扩展怎么加载调试？

A：先执行 pnpm web ext:dev，然后在 chrome://extensions/ 开启开发者模式，加载 apps/web/.output/chrome-mv3-dev 目录。

注意事项

图床（GitHub、阿里云、腾讯云、七牛云、MinIO、S3、Cloudflare R2 等）与 AI 模型（DeepSeek、OpenAI、通义千问等）需自行在编辑器内配置后使用。
登录账户后可同步编辑器偏好，具体见云同步说明文档。
项目支持本地草稿管理并自动保存内容，支持文件导入导出。

核心亮点

支持多图床（阿里云、腾讯云等），图片上传后自动替换为外链，避免微信图片失效
内置多种精美主题，一键切换，复制到公众号后样式保持完整
提供内容管理功能，可本地保存多篇草稿，方便写作和归档

不足之处

部分高级功能（如 AI 助手）可能需要配置 API Key，对小白用户有一定门槛
文档/社区待观察

适用场景

微信公众号文章快速排版
技术博客内容同步到公众号
团队协作撰写微信图文

替代项目

doocs/md、mdnice、wechat-format

项目介绍

md 是写作内容领域的开源项目，由 doocs 开发，2019 年首次发布。

在全站 13,014 个收录项目中，它的 GitHub 星标数（13,364）位列前 4%，在写作内容分类的 183 个项目里位列前 2%。

近 41 天，它的 GitHub 星标从 13,166 增加到 13,364，净增 198。

项目目前处于活跃维护状态，最近一次代码更新于 2026-09-22。完全免费，无付费版本。

它主要面向的使用场景是：微信公众号文章快速排版。同类可对比的替代方案包括 doocs/md、mdnice、wechat-format。

上一篇：bili-note

下一篇：open-knowledge

md