md

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

开源 🏷️完全免费 🔧 仅开源项目,无在线服务,需自行部署 开源模型 🍴 复刻 2250 🐛 待处理 17 👀 关注 81
访问官网 ↗ GitHub ↗
GitHub 星标 ★ 13516
维护状态 活跃
是否开源 开源
定价模式 🏷️完全免费 开源项目,完全免费,无付费版本。

项目预览

md 项目界面预览图
图片来源:GitHub 官方仓库名片

项目数据

分类开源模型
开发团队doocs
定价模式🏷️完全免费
价格说明开源项目,完全免费,无付费版本。
访问状态🔧 仅开源项目,无在线服务,需自行部署
是否开源是
开源协议WTFPL
主要语言TypeScript
技术栈/模型ai-bot,doocs,editor,llm,markdown,markdown-editor,tailwindcss,vite,vue,vue3,wechat,weixin
GitHub 星标★ 13516
上线时间2019-11-01 00:00:00
代码更新2026-11-03
仓库体积69.1 MB
本站数据更新2026-11-08
维护状态活跃
收录时间2026-08-09
浏览次数7

项目介绍

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

Star 增长趋势

本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整

数据来源:GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 13516

使用教程

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

环境要求

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

安装与启动步骤

  1. 1安装 Node 版本

    用 nvm 安装并使用项目指定的 Node 版本,未安装 nvm 需先自行准备。

    nvm i && nvm use
  2. 2安装项目依赖

    在仓库根目录安装全部依赖,需先克隆项目并进入目录。

    pnpm i
  3. 3启动开发模式

    启动本地开发服务,启动后浏览器访问 http://localhost:5173/md/ 即可使用编辑器。

    pnpm web dev
  4. 4构建生产产物

    部署在 /md 路径下用 build,部署在根路径下用 build:h5-netlify,二者按需选择。

    pnpm web build
    pnpm web build:h5-netlify
  5. 5开发浏览器扩展

    在 chrome://extensions/ 开启开发者模式,加载 apps/web/.output/chrome-mv3-dev 目录。

    pnpm web ext:dev
  6. 6部署到 Cloudflare

    分别用于 Cloudflare Workers 的本地开发预览与线上部署。

    pnpm web wrangler:dev
    pnpm web wrangler:deploy
  7. 7CLI 私有化部署

    全局安装 @doocs/md-cli 后执行 md-cli 启动,默认监听 8800 端口。

    npm i -g @doocs/md-cli
    md-cli
  8. 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

上一篇:bili-note

下一篇:open-knowledge

同类项目推荐

Long-Novel-GPT 开源

用 GPT 一口气写完整部长篇小说,告别断更烦恼

该项目包括一个基于 GPT 等大语言模型的长篇小说生成器,同时还有各类小说生成 Prompt 以及···

★ 1253 2026-08-09
md-translator 开源

翻译 Markdown 文档,代码公式链接格式全保留

⚡ Translate Markdown without breaking format — code blocks, LaTeX, FrontMatter, li···

★ 89 2026-08-09
agent-style 开源

给 AI 代理装上技术写作规范,输出不再啰嗦。

21 writing rules for AI coding and writing agents. Drop-in for Claude Code, Codex, C···

★ 736 2026-09-16
polywise 开源

让内容活起来,自托管智能代理内容系统

The open source agentic content system to make your contents alive. Self-hosted on a···

★ 654 2026-08-09
shakespeare-writing-studio 开源

让AI写稿更像真人,数据引用有据可查

Agent-ready writing studio for Chinese WeChat articles, English essays, research wri···

★ 180 2026-08-09
PacificOceanAI 开源

在 Overleaf 里一键调用 AI,让 LaTeX 写作和润色不再头疼。

AI-powered writing assistant for Overleaf LaTeX editor - Chrome/Edge extension with ···

★ 141 2026-08-09
unslop 开源

装上它,AI 回复秒变人话,不再满屏破折号和客套话。

Make AI output sound human. Strips AI-isms (sycophancy, stock vocab, hedging stacks,···

★ 183 2026-08-09
WRITING.md 开源

先立写作规矩,AI下笔不跑偏

"Humanizer" rules that make AI text sharper, genre-aware, with concrete anchors and ···

★ 389 2026-08-09
NovelForge 开源

卡片攒素材写长篇,越写越顺不卡壳

AI辅助长篇小说创作,卡片式创作,支持基于 JSON Schema的结构化 AI 生成与上下文引用,可···

★ 1275 2026-08-09