https://ibigqiang.github.io/mdPro/
Markdown 文档自动即时渲染为微信图文,让你不再为微信内容排版而发愁!只要你会基本的 Markdown 语法(现在有了 AI,你甚至不需要会 Markdown),就能做出一篇样式简洁而又美观大方的微信图文。
如果这个项目对你有帮助,请给我们点个 Star ⭐️,我们会持续更新和维护!
本仓库是基于 https://github.com/doocs/md 开源版本优化迭代而来,集合以上优化升级修改文件内对应内容。
推荐使用 Chrome 浏览器,效果最佳。
现有的开源微信 Markdown 编辑器样式繁杂,排版过程中往往需要额外调整,影响使用效率。为了解决这一问题,我们打造了一款更加简洁、优雅的编辑器,提供更流畅的排版体验。
欢迎各位朋友随时提交 PR,让这款微信 Markdown 编辑器变得更好!如果你有新的想法,也欢迎在 💬 Discussions 讨论区反馈。
- ✅ 完整 Markdown 支持 - 支持所有基础语法、数学公式
- ✅ 图表渲染 - 支持 Mermaid 图表和 GFM 警告块
- ✅ PlantUML 支持 - 强大的 UML 图表渲染
- ✅ Ruby 注音扩展 - 支持
[文字]{注音}、[文字]^(注音)格式,支持多种分隔符
- ✅ 代码高亮 - 丰富的代码块高亮主题,提升代码可读性
- ✅ 自定义样式 - 允许自定义主题色和 CSS 样式,灵活定制展示效果
- ✅ 草稿保存 - 内置本地内容管理功能,支持草稿自动保存
- ✅ 多图床支持 - 提供多种图床选择,便捷的图片上传功能
- ✅ 文件管理 - 便捷的文件导入、导出功能,提升工作效率
- ✅ AI 集成 - 集成主流 AI 模型(DeepSeek、OpenAI、通义千问、腾讯混元、火山方舟、302.AI 等),智能辅助内容创作
| # | 图床 | 使用时是否需要配置 | 备注 |
|---|---|---|---|
| 1 | 默认 | 否 | - |
| 2 | GitHub | 配置 Repo、Token 参数 |
如何获取 GitHub token? |
| 3 | 阿里云 | 配置 AccessKey ID、AccessKey Secret、Bucket、Region 参数 |
如何使用阿里云 OSS? |
| 4 | 腾讯云 | 配置 SecretId、SecretKey、Bucket、Region 参数 |
如何使用腾讯云 COS? |
| 5 | 七牛云 | 配置 AccessKey、SecretKey、Bucket、Domain、Region 参数 |
如何使用七牛云 Kodo? |
| 6 | MinIO | 配置 Endpoint、Port、UseSSL、Bucket、AccessKey、SecretKey 参数 |
如何使用 MinIO? |
| 7 | 公众号 | 配置 appID、appsecret、代理域名 参数 |
如何使用公众号图床? |
| 8 | Cloudflare R2 | 配置 AccountId、AccessKey、SecretKey、Bucket、Domain 参数 |
如何使用 S3 API 操作 R2? |
| 9 | 又拍云 | 配置 Bucket、Operator、Password、Domain 参数 |
如何使用 又拍云? |
| 10 | Telegram | 配置 Bot Token、Chat ID 参数 |
如何使用 Telegram 图床? |
| 11 | Cloudinary | 配置 Cloud Name、API Key、API Secret 参数 |
如何使用 Cloudinary? |
| 12 | 自定义上传 | 是 | 如何自定义上传? |
# 安装 node 版本
nvm i && nvm use
# 安装依赖
pnpm i
# 启动开发模式
pnpm web dev
# 访问 http://localhost:5173/md/
# 部署在 /md 目录
pnpm web build
# 部署在根目录
pnpm web build:h5-netlify
# Chrome 插件启动及调试
pnpm web ext:dev
# 访问 chrome://extensions/ 打开开发者模式,加载已解压的扩展程序,选择 apps/web/.output/chrome-mv3-dev 目录
# Chrome 插件打包
pnpm web ext:zip
# Firefox 扩展打包(how to build Firefox addon)
pnpm web firefox:zip # output zip file at in apps/web/.output/md-{version}-firefox.zip
# uTools 插件打包
pnpm utools:package # output zip file at apps/utools/release/md-utools-v{version}.zip
# cloudflare workers
pnpm web wrangler:dev # cloudflare workers dev 模式
pnpm web wrangler:deploy # cloudflare workers 部署命令如果您想在本地运行本项目进行测试或二次开发,请参考以下步骤:
1. 克隆仓库到本地
git clone https://github.com/iBigQiang/mdPro.git
cd mdPro2. 安装依赖 项目使用 pnpm 进行包管理:
pnpm install3. 启动开发模式
pnpm web dev运行后,在浏览器访问:http://localhost:5173/md/ 即可预览实时修改效果。
提示:为何是
/md/而不是/mdPro/?这是因为本地开发环境下 Vite 默认配置了/md/作为 base 路径,而/mdPro/仅在发布到 GitHub Pages 时生效。
本项目支持通过 Docker 快速部署,镜像托管在 GitHub Container Registry (GHCR)。
Important
首次部署提示:如果拉取镜像时报错 denied: denied,是因为 GHCR 镜像默认为私有。请前往 GitHub 仓库的 Packages 页面,进入 mdpro 设置,将 Package Visibility 设置为 Public。
docker pull ghcr.io/ibigqiang/mdpro:latestdocker run -d --name mdpro -p 8080:80 ghcr.io/ibigqiang/mdpro:latest运行后,访问 http://localhost:8080 即可使用。
在根目录下直接运行:
docker-compose up -d附 docker-compose.yml 内容:
services:
mdpro:
image: ghcr.io/ibigqiang/mdpro:latest
container_name: mdpro
ports:
- '8080:80'
restart: always如果您想基于本地修改后的代码或最新的 master 分支构建镜像,可以参考以下步骤:
1. 克隆仓库到本地
git clone https://github.com/iBigQiang/mdPro.git
cd mdPro2. 构建 Docker 镜像
docker build -t my-mdpro .3. 启动容器
docker run -d --name my-mdpro -p 8080:80 my-mdpro本项目集成了高度自动化的发布流程,运维人员只需执行一条命令即可完成版本更新、Tag 打标、代码推送及 Docker 镜像构建。
在项目根目录下运行:
pnpm release该命令会自动执行以下操作:
- 自动提取日志:从
升级日志文档.md中提取最新的增量更新内容。 - 版本更新:自动更新
package.json中的版本号。 - Git 提交:自动执行
git commit,提交信息包含版本号。 - 打标签:自动创建对应的 Git Tag (如
v1.2.0)。 - 代码推送:自动执行
git push推送代码及 Tag 到远程仓库。 - 触发构建:GitHub Actions 监听到 Tag 推送后,会自动触发 CI/CD 流程,构建并发布最新的 Docker 镜像。
命令执行完成后,您可以访问以下链接查看发布状态:
- Release 页面: https://github.com/iBigQiang/mdPro/releases
- 构建状态: https://github.com/iBigQiang/mdPro/actions
请查看 📋 USERS.md 文件,了解使用本项目的公众号。
我们欢迎任何形式的贡献!请查看 📖 CONTRIBUTING.md 获取提交 PR、Issue 的流程与规范。
如果本项目对你有所帮助,可以通过以下方式支持我们的持续开发。
如果你在使用过程中遇到问题,或者有好的建议,欢迎在 🐛 Issues 中反馈。你也可以加入我们的交流群,和我们一起讨论,若群二维码失效,请添加好友,备注 md,我们会拉你进群。




