IPYNB 转 ADOC转换器
所有处理都在你的设备上完成，大文件可能需要一点时间。
Jupyter Notebook与AsciiDoc (ADOC)的定位并不相同：IPYNB 是 Jupyter Notebook 的格式：一个 JSON 文档，混合 Markdown 单元、代码单元、输出与元数据。它是数据科学工作的默认载体——每份分析、教程和 Kaggle kernel 都是它。ADOC 与 AsciiDoc 的转换方式完全一致：转 Word、Markdown 或 HTML。
本转换器通过 WebAssembly 完全在你的浏览器内运行——文件不会离开你的设备，全程无上传、无水印、无注册、无排队。支持一次拖入多个文件批量转换。
IPYNB 与 ADOC 的对比
| IPYNB | ADOC | |
|---|---|---|
| 数据结构 | JSON + 内嵌输出 | 纯文本标记（==、[source]、|===） |
| 最适合 | 数据科学、教学、分析 | 技术书与大型文档集 |
如何将 IPYNB 转换为 ADOC
- 1
选择文件
选择你的 IPYNB 文件。
- 2
立即转换
文件先转换成 Markdown（保留标题、列表与段落的中间格式），再重建为目标格式。
- 3
下载结果
下载 ADOC——结构保留，复杂排版被简化。
关于 IPYNB 格式
Jupyter Notebook（.ipynb）是数据科学的工作文档：一个 JSON 数组，混合叙事用的 Markdown 单元、跑 Python/R/Julia 的代码单元，以及被捕获的输出——表格、图表、报错。每个 Kaggle kernel、教程和分析备忘都是它。
notebook 在 Jupyter 之外很难阅读，也没法直接交给管理层。转成 Markdown/Word/HTML 能把叙述与结果变成可分享的报告——或者把一份书面报告变成随时可填的 notebook 骨架。
+优点
- ✓叙述 + 代码 + 输出在同一文件
- ✓数据科学工作流的通用语
- ✓可执行——结果可以复现
!局限
- −离开 Jupyter 的 JSON 无法阅读
- −输出让文件膨胀并可能泄露敏感信息
- −合并冲突出了名的痛苦
关于 ADOC 格式
AsciiDoc 是轻量标记长大后的样子。Markdown 止步于粗体和列表，而 AsciiDoc 能承载扉页、多级章节、标注、警示、交叉引用和真正的表格语法——足以全程用纯文本写出整本技术书。Git 与 Linux 内核文档生态都以它为标准，通过 Asciidoctor 渲染。
这个格式的弱点是工具引力：Asciidoctor/Ruby 世界之外的 AsciiDoc 转换器很稀缺——这正是 Pandoc 补位的地方。转成 Word 可把书稿交到 Office 里的编辑手上；转成 Markdown 可接入现代文档站。章节结构与表格全程保留。
+优点
- ✓书籍级结构：章节、标注、警示、交叉引用
- ✓驱动 Git 与 Linux 内核文档——大规模实战检验
- ✓纯文本状态下依然可读
!局限
- −对随手笔记而言语法比 Markdown 重
- −转换器生态集中在 Asciidoctor 工具链
- −方言多（旧 asciidoc 与 asciidoctor）
为什么把 IPYNB 转换成 ADOC？
转换的意义在于 ADOC 的长处正好补上 IPYNB 给不了的东西：书籍级结构：章节、标注、警示、交叉引用而另一边，离开 Jupyter 的 JSON 无法阅读用上面的转换器过一遍，你的文件就站到了正确的取舍那边。
常见问题
IPYNB 转 ADOC 真的免费吗？
完全免费，无需注册、无水印、也没有每日次数限制。网站依靠广告维持运营。
我的文件会被上传到服务器吗？
不会。转换通过 WebAssembly 完全在你的浏览器内完成，文件不会离开你的设备——这正是它既快又私密的原因。
Windows、Mac、iPhone、安卓都能用吗？
可以。任何装有现代浏览器的设备都适用：Windows、macOS、Linux、安卓和 iOS，无需安装任何软件。
IPYNB 转 ADOC 有文件大小限制吗？
由于不上传，唯一的限制是你设备的内存。现代桌面浏览器处理几百 MB 的文件都没问题，超大文件只是需要稍等片刻。
转换可以离线进行吗？
可以。页面加载完成后，转换完全在浏览器内运行——你甚至可以断网继续转换。任何文件都不会经过服务器。
IPYNB 文件的排版会完全保留吗？
本转换器会把 IPYNB 的内容渲染成 ADOC，在目标格式允许的范围内尽量保持页面、比例与图片原样。下载前请用预览确认效果符合预期。