wandao is a free, open source documentation & knowledge base project written in Python and released under AGPL-3.0. It has 1,146 GitHub stars, 117 forks and 19 open issues, and was last pushed 11 days ago. On this registry it ranks #75 of 100 tracked projects in Documentation & Knowledge Base, with 5 head-to-head comparisons available.

What is wandao?

Wandao (万能导) is a multi-platform knowledge-base Markdown import and export tool that turns content you have permission to access into local Markdown and pushes local Markdown back into supported platforms, built for people who need to back up, migrate, or study documentation without manual copying and pasting.

What it is

Wandao is an open-source desktop application written in Python and licensed under AGPL-3.0, with the 1.4.x desktop front end built on Tauri 2. It lives in the note-taking, knowledge-base and data-portability corner of the tooling ecosystem, and the repository topics — backup, data-portability, migration-tool, markdown, note-taking, evernote, feishu, obsidian, onenote — describe that placement accurately. Its stated purpose is to export knowledge bases a user may access as local Markdown, and to import prepared Markdown into other platforms, while keeping directory structure, body formatting, images and attachments as intact as the source allows.

The specific thing it replaces is manual copy-and-paste followed by manual tidying. Moving documents between 飞书 Wiki, 语雀, 阿里云 Thoughts, 印象笔记, 有道云笔记, 为知笔记, OneNote, 知识星球, ima 知识库, 钉钉文档, WPS 文档, 息流, Obsidian, 知乎, CSDN, 微信公众号 and plain local Markdown normally means re-creating folder trees, re-uploading images and losing attachments. Wandao reads the real directory tree, lets the user select by folder or by document, and processes the selection as a task that can be stopped, continued or retried.

Key capabilities

  • Export from named sources including 语雀 (knowledge base, directory, Markdown, images, attachments), 飞书 Wiki (wiki directory, native documents, Markdown files), 知识星球 (posts with optional comments and attachments), 印象笔记 (by notebook), 有道云笔记 (directory tree, body images, attachments), 阿里云 Thoughts workspaces, 钉钉文档, WPS 云文档, 息流, ima 知识库, Obsidian Vault archiving with resource copying and reference rewriting, and single-article export for 知乎, CSDN and 微信公众号.
  • Import into 飞书 Wiki (batch Markdown import that restores multi-level directory structure), 语雀 (create or update knowledge-base documents and upload images and attachments), 印象笔记 (batch Markdown, images, attachments) and ima 知识库 (upload to a knowledge base or an existing folder).
  • Directory structure control: the tool reads the real directory tree and lets the user pick by folder or by individual document.
  • Resource localization: body images and attachments are preserved locally where the platform permits it.
  • Task handling: incremental processing skips completed content, and failures can be retried while progress, logs and task reports stay visible in 任务中心.
  • Plugin center: platform capabilities can be downloaded, updated and rolled back independently of the application.
  • Local-first storage: credentials and task data stay on the user's own computer, and the desktop build offers theme switching, search and version checking.

Who uses it and how

  • Individuals backing up personal knowledge bases from 印象笔记, 有道云笔记, 为知笔记 or 知识星球 into a local Markdown archive they own.
  • Teams and knowledge managers migrating a whole 语雀 or 飞书 Wiki space, exporting it and then batch-importing it into another platform with the folder hierarchy, images and attachments reconstructed.
  • Learners who export course documentation and project source into one directory and hand it, together with prompts/项目学习导师提示词.md, to an AI that can read local files.
  • Writers and publishers pulling a single 知乎 column article or answer, a CSDN blog post, or one public 微信公众号 article with its body images into Markdown.
  • Obsidian users archiving a local Vault, copying its resources and rewriting references, and Windows-only users exporting OneNote while keeping the notebook, section and page hierarchy.

Getting started

Download the Windows x64 or macOS Apple Silicon (arm64, macOS 11+) installer from GitHub Releases, then pick the platform and the import or export action in 平台中心; the release bundles its runtime, so no Python or Node.js installation is needed. On macOS Apple Silicon the release is not signed with a Developer ID and is not notarized by Apple, so if Gatekeeper blocks the first launch, confirm the source under 系统设置 → 隐私与安全性 and choose to open it anyway — do not clear the quarantine attribute to bypass the system check. Source development instead requires Python 3.10+, Node.js 22.12+ and Rust 1.88.0, started through .\start-wandao.cmd on Windows or ./start-wandao.sh on macOS.

How it compares

The facts provided list no paid products that Wandao replaces, and they name no other tool performing the same multi-platform Markdown import and export — Obsidian and Notion appear as source or target platforms and as a migration tutorial rather than as alternatives. Within this registry it therefore stands alone.

When to use it — and when not to

Wandao is a local desktop application, so a self-hoster operates no database, storage service or SMTP server, but credentials and task data live on the user's own machine and results depend on platform logins and on the automation browser selected in 设置. It is a poor fit for anyone who needs unattended scheduled backup of 微信公众号 article history or comments, which it does not read, for OneNote export on a non-Windows machine, or for fully automated Notion imports, since Notion is covered only by a tutorial pointing at Notion's own Markdown export. Honest weaknesses visible in the facts are that the documentation and release material are written in Chinese, that the macOS build ships unsigned and un-notarized, and that the repository carries 19 open issues against a codebase still adding platform plugins.

project readme (upstream, from github) — read inline

万能导 Wandao ✨

让知识没有壁垒,让多平台文档迁移更简单。

将你有权访问的知识库导出为本地 Markdown,或把本地 Markdown 导入其他平台。
尽量保留目录结构、正文格式、图片与附件,告别重复复制和手动整理。

最新版本 累计下载 插件下载 GitHub Stars GitHub Forks 全部 GitHub Issues AGPL-3.0 License Windows x64 与 macOS Apple Silicon

Windows   macOS   Markdown   Python

📦 下载最新版  ·  📖 使用教程  ·  🧠 AI 辅助学习  ·  🐛 反馈问题  ·  🤝 参与共创

万能导是一个多平台知识库 Markdown 导入导出工具,目前支持飞书、语雀、阿里云 Thoughts、印象笔记、有道云笔记、为知笔记、OneNote、知识星球、ima 知识库、钉钉文档、WPS 文档、息流、Obsidian、Notion、知乎、CSDN、微信公众号和本地 Markdown 等内容来源与目标平台。

你可以把自己有权限访问的项目资料、团队知识库和课程文档导出为本地 Markdown,也可以把整理好的本地 Markdown 导入到支持的平台。万能导重点处理文档格式、图片、附件和目录层级,适合知识备份、平台迁移、学习资料整理,以及将“教学文档 + 源码项目”交给 AI 一起阅读。

如果有未能完整导出的内容或希望支持的新平台,欢迎提交 GitHub Issue。建议新平台不要求参与开发,平台使用经验、公开资料和测试意愿同样有价值;每一条可复现的反馈和共创需求都会被认真审查。

如果这个项目对你有帮助,欢迎在 GitHub 点一个 Star ⭐,这对我真的很重要~


💗 特别赞助

Fluxion AI · 为 AI 辅助学习提供支持

本区为赞助信息。万能导始终完全开源免费,AI 辅助学习不绑定任何模型或 API 服务。

Fluxion AI 面向个人开发者、技术团队与企业,通过统一 API 接入全球主流 AI 模型,并以多线路调度提升可用性;模型质量、使用情况和费用可在一个平台集中管理。

灵活的线路与计费方案带来更具竞争力的调用成本,实时价格和每笔消费均可查阅。

兑换码:WANNENGDAO — 登录后在工作台「兑换」输入,即可获得 $3 API 额度。

访问 Fluxion AI  ·  查看 AI 辅助学习用法


🧠 AI 辅助学习

把课程资料、项目文档和源码导出到同一目录后,可将它们连同 项目学习导师提示词 交给支持本地文件阅读的 AI。它会结合“教学文档 + 真实代码”讲解业务流程、核心实现和技术取舍,帮助你更系统地学习项目。

查看完整提示词与使用方法 →


🖼️ 界面预览


首页:选择平台、开始新任务或继续最近任务

平台中心:浏览已接入平台并选择导入、导出或教程

任务中心:查看历史进度、失败原因并继续任务

教程公告:在应用内阅读最新公告和使用教程

插件中心:搜索、安装和更新需要的平台插件

设置:选择自动化浏览器、显示模式并检查版本

✨ 为什么使用万能导

能力 能力
🧭 目录结构:读取真实目录树,按文件夹或文档选择 🖼️ 资源本地化:尽量保留正文图片和附件
🔁 任务恢复:支持停止、继续和失败重试 📊 过程可见:提供实时进度、日志和任务报告
⚡ 增量处理:跳过已完成内容,减少重复工作 🧩 插件中心:平台能力可独立下载、更新和回滚
🔐 本地优先:凭证和任务数据保存在用户电脑 🌙 桌面体验:支持主题切换、搜索和更新检查

🚀 支持的平台

平台按导出、导入和教程三类展示;更多平台能力可在应用内“插件中心”获取。

导出

平台 主要能力
🌟 知识星球 项目、专栏、帖子与文章页,可选评论和附件
🪶 语雀 知识库、目录、Markdown、图片与附件
🪽 飞书 Wiki Wiki 目录、原生文档和 Markdown 文件
☁️ 阿里云 Thoughts 工作区文档导出
🐘 印象笔记 按笔记本导出 Markdown、图片和附件
📝 有道云笔记 目录树、正文图片和附件
📒 为知笔记 网页版登录、目录与图片
🗂️ OneNote 保留笔记本、分区和页面层级,仅 Windows
🤖 ima 知识库 按知识库、文件夹或文档选择
📌 钉钉文档 知识库目录读取与 Markdown 导出
🟥 WPS 文档 云文档读取与 Markdown 导出
🌊 息流 空间内容读取与 Markdown 导出
💎 Obsidian 本地 Vault 归档、资源复制与引用重写
🟦 知乎 单篇专栏文章与回答导出,可选下载正文图片
🟩 CSDN 单篇博客文章导出;安全验证或登录后自动继续
💬 微信公众号 单篇公开文章导出,保留正文图片;不读取历史文章与评论
➕ 等更多平台 更多平台将通过插件中心持续接入

导入

平台 主要能力
🪽 飞书 Wiki 批量导入 Markdown,并恢复多层目录结构
🪶 语雀 创建或更新知识库文档,上传图片和附件
🐘 印象笔记 批量导入 Markdown、图片和附件
🤖 ima 知识库 上传本地文档到知识库或已有文件夹
➕ 等更多平台 更多导入能力将通过插件中心持续接入

教程

平台 主要能力
◼️ Notion 使用官方 Markdown 导出与迁移能力
➕ 等更多平台 暂不适合自动化的平台也可以先提供迁移教程

⚡ 快速开始

  1. 打开 GitHub Releases,下载 Windows x64 或 macOS Apple Silicon(arm64,macOS 11+)安装包
  2. 启动 Wandao,在“平台中心”选择目标平台和导入/导出操作
  3. 按界面提示登录或填写链接,然后读取目录
  4. 勾选需要处理的文档并开始任务
  5. 在“任务中心”查看进度、报告,或继续支持恢复的任务

发行版已内置运行环境,普通用户不需要安装 Python、Node.js,也不需要从源码启动。

macOS Apple Silicon 首次打开: 当前正式 Release 未做 Developer ID 签名和 Apple 公证。请只从本项目 GitHub Releases 下载并移入“应用程序”;Gatekeeper 阻止时,可在“系统设置 → 隐私与安全性”确认来源后选择仍要打开。不要通过清除隔离属性绕过系统校验。

详细操作和平台注意事项请查看 使用教程。

🧑‍💻 源码启动与本地开发

源码启动适合参与开发、调试插件或当前没有合适发行版的情况。1.4.x 桌面端基于 Tauri 2;源码开发需要 Python 3.10+、Node.js 22.12+、Rust 1.88.0 和对应系统的 Tauri 前置依赖。

Windows:

git clone https://github.com/tllovesxs/wandao.git
cd wandao
.\start-wandao.cmd

macOS:

git clone https://github.com/tllovesxs/wandao.git
cd wandao
chmod +x ./start-wandao.sh
./start-wandao.sh

国内网络环境可将仓库地址替换为 https://gitee.com/shi-xiansong/wandao.git。


🛠️ 质量检查与打包

提交代码或打包前运行完整质量检查:

python scripts\quality_check.py

涉及 wandao_electron/src-tauri/ 时,还需使用 Rust 1.88.0 运行格式、测试和 Clippy 门禁;CI 使用同一固定版本。

Windows 本地未签名 smoke 打包:

cd wandao_electron
npm ci
npm run build:win:unsigned

本地与手动工作流生成的 UNSIGNED-SMOKE 包只能用于 smoke,不得直接发布。正式 v* tag 工作流当前也生成未签名 Windows/macOS 安装包,但会额外执行版本一致性、真实安装/资源 smoke、校验和、SBOM 和 provenance 门禁。更完整的维护说明见 发布与回滚手册。


🔐 使用与安全

万能导不会破解登录或绕过平台权限。请只处理你有权访问的内容,并遵守对应平台的服务条款和版权要求。不要将导出内容用于未获授权的传播、售卖或公开发布,也不要通过降低延迟进行高频请求。

登录凭证和任务数据保存在本机。请勿在 Issue、PR、截图或日志中公开 Cookie、账号密码、Token、API Key、App Secret 等敏感信息。

更多说明见 合规说明、安全策略 和 本地数据存储策略。

🤝 参与共创

欢迎参与新平台适配、导入导出质量优化、Bug 修复、界面改进和文档维护。不会开发也可以通过“新平台接入建议 / 共创认领”Issue 模板建议新平台。准备开发新平台或较大功能时,请先搜索已有 Issue/PR,再提交 Issue 认领;认领后 2 天内提交 Draft PR 或可验证进展,复杂任务需说明情况并至少每 2 天同步一次。

入口 用途
贡献指南 提交代码前需要了解的基本规则
共创流程 认领 Issue、准备验收材料和提交 PR
插件开发与发布 新平台插件结构、校验与发布方式
GitHub Issues 反馈 Bug、提出建议或认领功能

🔗 项目与联系

项目 地址
GitHub tllovesxs/wandao
Gitee shi-xiansong/wandao
联系邮箱 tl200599@163.com
作者微信 pressure_spring

📈 Star History

万能导 GitHub Star 历史趋势

📄 License

本项目采用 GNU Affero General Public License v3.0 开源。

万能导:让知识没有壁垒。
如果这个项目对你有帮助,欢迎在 GitHub 点一个 Star ⭐

Frequently asked questions

Is wandao free to use?

wandao is open source under the AGPL-3.0 licence. There is no licence fee and no seat count — you can self-host it or, where the project offers one, pay a vendor for a managed version instead.

What does wandao do?

万能导:多平台知识库 Markdown 全项目一键导入导出工具(导入导出效果最好),用自动化代替手动复制粘贴(有道云,飞书,语雀,阿里云知识库,知识星球,印象笔记,ima,onenote,为知笔记,csdn,知乎,微信公众号导出导入).(可保留目录结构,图片,项目格式) 关键词:微信公众号导出,语雀导出导入,飞书导出导

What is wandao written in?

wandao is primarily written in Python. Its source is publicly available at https://github.com/tllovesxs/wandao, and it has 1,146 GitHub stars.