Jupyter Book
把 Jupyter Notebook 和 Markdown 变成可发布网站的开源出版工具,构建时执行代码并把结果嵌进页面,适合研究者把实验报告连代码带文字一起发布。
4 次可以打开平均 2.5 秒11 月 16 日 起国内不可直接访问
本站从国内机房定期实测。竖条由远及近:绿 = 可以打开,橙 = 国内不可直接访问,灰 = 打不开。Jupyter Book 是一个把计算笔记变成书的工具。你在 Jupyter Notebook 或 Markdown 里写内容,它负责执行代码、交叉引用章节和图表,最后生成一个可以发布到网上的站点。适合需要把分析过程、代码和文字放在一起展示的人,比如写实验报告的研究者、做课程材料的老师,或者整理数据项目文档的工程师。
主要功能
它支持在构建时执行 Python、R、Julia 等代码,把运行结果直接嵌进页面,这样读者看到的数字和图表都来自真实运行。页面之间可以互相引用章节、图、表、公式,也能链接到其他用 MyST 搭建的站点。如果内容里有交互组件,可以连到 JupyterHub、Binder,或者直接在浏览器里跑 Python。
安装后基本流程是三条命令:pip install jupyter-book 装好,jupyter book init 初始化目录结构,jupyter book start 构建并启动预览。官方文档里还有快速开始、写作指南、发布指南和插件扩展几个入口,按你想做的事分开。
版本与限制
目前主推的是 Jupyter Book 2,底层换成了 MyST 文档引擎,构建速度更快,工作流也有调整。官方自己说明 2 还有很多地方要改进,页面上放了从 1.0 升级的指南、已知限制和常见问题。如果你手头有旧版项目,升级前最好先翻一遍这些说明。
费用与支持
工具本身开源,用 pip 安装即可,没有提到付费版本。遇到问题可以去 FAQ、Discord 或 Discussions 里问,也可以给功能投票。做研究引用它时,官方提供了引用指南。
