WeChat to Markdown
WeChat to Markdown (wx2md) 是由望山开发的本地优先 Chrome/Edge 扩展，把微信公众号文章保存为 Markdown；内容在本地处理不上传；官网 https://wx2md.com
WeChat to Markdown (wx2md) is a local-first Chrome/Edge extension developed by 望山 that saves WeChat Official Account articles as Markdown. Content is processed locally and is not uploaded. Official site: https://wx2md.com
本仓库是 Community 开源核心，版本 v0.3.0。源码只包含公众号单篇 Markdown、图片 ZIP 和快捷保存，不代表官网分发的商店产品。商店产品在一个安装包内提供免费与会员权益，另含普通文章型网页、本地文章库和合集等能力。官网仅提供 Chrome 和 Edge 官方商店在线安装，不再分发离线安装包。当前能力和套餐见 常见问题 与 购买页。
官网 https://wx2md.com ｜ Chrome 商店一键安装 ｜ 源码
把读过的公众号文章，变成真正属于你的本地 Markdown 知识资产。
- 本地不上传
- MD / HTML / PDF / 图片
- 合集分卷
- Obsidian / 思源 / Typora / VS Code
将你有权访问的微信公众号文章保存为 Markdown，方便个人阅读、研究和知识整理。
WeChat to Markdown 是一个本地优先的 Chrome 扩展：不需要账号、后端或数据库，文章解析和 Markdown 生成均在你的浏览器中完成。
[!IMPORTANT]
本项目是一款通用的格式转换工具，不提供文章内容，也不代表用户取得了文章的复制、传播、改编或商业使用授权。请仅处理你有权访问和使用的内容。
功能
- 识别当前微信公众号文章页
- 提取标题、公众号、作者、发布时间和正文
- 清理脚本、广告节点和排版属性
- 保留链接、图片、列表、引用、表格等 Markdown 语义
- 生成包含来源链接的 YAML Front Matter
- 使用兼容 Windows 和 macOS 的文件名下载
.md
- 可选择下载文章图片，并导出包含 Markdown 与
images/ 的 ZIP
- 在公众号文章右下角提供快捷保存入口
- 支持
Alt+Shift+W 快捷键直接保存当前文章
- 全程本地处理，不上传文章内容
“下载文章图片”默认关闭：关闭时导出 .md 并保留网络图片；开启时导出 .zip，Markdown 中的图片地址会改为 ./images/ 下的本地文件。该偏好会保存在浏览器本地，并同时用于页面右下角的快捷保存按钮。
如果个别图片下载失败，导出的 Markdown 会为这些图片保留原网络地址，并在完成时显示失败数量。当前版本只处理用户主动打开并点击保存的单篇文章，不提供批量抓取、自动遍历、登录绕过、付费内容解锁或访问控制规避能力。
快捷键
在微信公众号文章页按 Alt+Shift+W，可以直接触发与右下角“存”按钮相同的保存流程。快捷键会沿用 Popup 中的“下载文章图片”偏好。
如需修改快捷键，请打开 chrome://extensions/shortcuts。如果扩展刚更新但当前文章页尚未刷新，快捷保存会通过扩展图标提示刷新页面后重试。
当前版本：v0.3.0。
安装
从 Chrome Web Store 安装（推荐）
本扩展已上架 Chrome Web Store，打开商店页面即可一键安装，无需开发者模式：
也可以直接在 Chrome Web Store 搜索 WeChat to Markdown。
从源码构建
需要 Node.js 20 或更高版本。
npm install
npm test
npm run build
然后：
- 打开
chrome://extensions
- 开启“开发者模式”
- 点击“加载已解压的扩展程序”
- 选择本项目生成的
dist 目录
打开一篇 mp.weixin.qq.com 文章后，可以点击扩展图标选择导出方式，也可以使用页面右下角的“存”按钮快速保存。
官网
正式官网是 https://wx2md.com ，不由本仓库发布。site/ 只保留说明，避免把过期页面、sitemap 或结构化数据当成线上站点。请不要从本仓库部署或覆盖官网。
合规使用
使用本项目时，你应自行确认拥有必要的访问和使用权限，包括但不限于：
- 仅保存你能够正常访问且有权使用的文章；
- 尊重作者署名、作品完整性及其他合法权益；
- 保留 Markdown 中的原作者、公众号和来源链接；
- 未经权利人许可，不公开转载、再次分发、出售或用于商业内容库；
- 不将导出内容用于训练、微调、检索增强生成或其他超出授权范围的 AI 用途；
- 不利用本项目绕过登录、付费、频率限制、技术保护措施或平台访问控制；
- 遵守所在地法律、文章权利人的授权条件，以及微信/微信公众号适用的服务协议和平台规则。
《中华人民共和国著作权法》规定了个人学习、研究或欣赏等合理使用情形，同时要求符合相应条件，并不得影响作品的正常使用或不合理地损害著作权人的合法权益。该限制不当然覆盖公开传播、商业使用或批量建立内容库。请参阅《中华人民共和国著作权法》官方文本及腾讯政策与协议入口。
如果你的使用场景涉及组织内部共享、商业产品、批量处理、AI 数据集或跨境传输，请在使用前取得权利人授权并咨询专业法律人士。
隐私与安全
- 本项目不设置服务器，不收集账号、Cookie、浏览历史或导出的文章内容。
- 扩展只在
https://mp.weixin.qq.com/* 页面注入内容脚本。
activeTab 用于读取用户当前主动打开的页面。downloads 用于把生成的 Markdown 保存到本地。storage 用于在本地保存“是否下载图片”的偏好。https://mmbiz.qpic.cn/* 权限仅用于用户选择图片归档后下载文章图片。- 导出文件仍可能包含原文中的远程图片链接；打开 Markdown 时，阅读器可能向图片服务器发起请求。
请勿提交包含文章正文、个人信息、Cookie、访问令牌或其他敏感数据的 Issue、日志或测试样本。
权利人通知与移除
本仓库不托管微信公众号文章。若你认为本项目仓库中的代码、示例、截图或其他材料侵犯了你的合法权益，请新建 Issue，并提供：
- 权利人及联系方式；
- 涉嫌侵权材料的准确位置；
- 权利归属或授权证明；
- 希望采取的处理措施。
维护者会在合理核验后处理仓库内可控制的材料。对于用户自行导出的本地文件，请直接联系该文件的持有人；维护者无法访问或删除这些文件。
为保护隐私，请勿在公开 Issue 中提交身份证件、住址、电话号码等不必要的敏感信息。如需非公开材料，可先在 Issue 中请求私下联系渠道。
商标声明
“微信”、WeChat、微信公众号及相关名称、商标和标识归其各自权利人所有。本项目为独立的开源项目，与腾讯或微信不存在隶属、合作、授权、认可或背书关系。项目名称仅用于说明兼容对象。
免责声明
本项目按“现状”提供，不保证对所有页面持续可用，也不保证导出结果完整、准确或适合特定用途。使用者应自行备份并核对导出内容。
维护者不对用户保存或使用第三方内容作出授权，也不为用户的具体使用行为提供法律意见。法律责任不能仅通过 README 或开源许可证排除；在适用法律允许的最大范围内，本项目作者和贡献者按照 MIT License 提供软件，不承担因使用或无法使用本软件产生的责任。
开发结构
src/content/ 微信页面识别、提取与清洗
src/core/ 领域类型、Markdown 和文件名规则
src/popup/ 扩展交互界面
tests/ 单元测试
site/ 说明：正式官网是 https://wx2md.com ，本目录不发布站点
路线图
- 可配置文件命名规则
- 可选 Front Matter 字段
- 在合法授权范围内支持更多公开网页
新增能力仍会遵循“用户主动操作、最小权限、本地处理”的边界，不接受绕过访问控制或批量抓取受保护内容的功能。
交流与反馈
欢迎添加我的微信，交流插件使用、开发和知识管理。添加时请备注 WeChat to Markdown，方便我识别来意。
功能缺陷和可复现的问题仍建议提交 Issue，便于公开跟踪和帮助其他使用者。权利人通知请按照上文“权利人通知与移除”流程提交，不要通过微信发送身份证件等敏感材料。
贡献
欢迎提交 Issue 和 Pull Request。贡献内容必须由贡献者原创，或已获得与本项目许可证兼容的授权；请勿提交从第三方产品复制的代码、素材、文章正文或受限制数据。
安全问题请勿附带真实用户数据或未脱敏文章内容公开披露。
License
本项目源代码采用 MIT License 开源。
该许可证仅适用于本仓库中由项目作者提供的源代码和原创材料，不适用于通过本工具访问、转换或导出的第三方文章、图片、商标及其他内容；这些内容的权利仍归各自权利人所有。
致谢
感谢 Linux.do 社区的支持与反馈。
