
Obsidian 里记了满屏 Markdown,跑 Python 却要切到 Jupyter 或 VS Code,来回复制结果。本篇把 obsidian-jupyter-notebook 这款插件讲透:它让你在 Obsidian 里直接创建、编辑和运行标准 .ipynb 文件,Markdown 笔记、Python 代码和执行结果待在同一个 Vault 里;代价是它只支持桌面端,代码只能在本机 Python 环境里跑。
软件信息
| 项目 | 说明 |
|---|---|
| 软件名 | Obsidian Jupyter Notebook(插件名 Jupyter Notebook,ID jupyter-notebook) |
| 最新版本 | 0.7.0(MIT 开源,已发布 25 个版本) |
| 前置要求 | Obsidian 1.8.7 及以上,桌面端(Windows / macOS / Linux) |
| 文件格式 | 标准 .ipynb(nbformat 4),Jupyter / VS Code 通用,不生成伴随文件 |
| 语言 | 中英双语 |
| 执行方式 | 本机 Python 环境,不支持远程 Jupyter 服务器 |
版本与获取方式:怎么选
结论先行:新用户直接装 0.7.0;从旧版 obsidian-ipynb 升级的人,先备份再迁移,两版绝不同时启用。
| 获取方式 | 说明 | 适合谁 |
|---|---|---|
| Release 三文件手动安装(推荐) | 下载 main.js、manifest.json、styles.css,放入 Vault 的 .obsidian/plugins/jupyter-notebook/,重启后在”第三方插件”里启用 | 所有人:版本可控,按官方步骤来最稳 |
| 社区插件市场搜索安装 | 搜 Jupyter Notebook 一键安装 | 图省事的人 |
| 旧版 obsidian-ipynb 直接覆盖 | 不推荐这么干 | 没人:先备份旧目录和 data.json,按迁移步骤来 |
安装关键卡点
- .ipynb 文件在文件列表里看不到:去”设置→文件与链接”打开”检测所有文件扩展名”,Obsidian 默认不显示 ipynb 后缀。
- 和其他 Notebook 插件冲突:一次只启用一个 .ipynb 查看或编辑插件,多个同时开会抢文件关联。
- 旧版迁移三步:先备份旧 obsidian-ipynb 目录;完全退出 Obsidian 后,把旧目录的 data.json 拷进新 jupyter-notebook 目录保留设置;ipynb-envs/ 和 ipynb-runtimes/ 别删,装完重新选一次本地环境。两版绝不同时启用。
- 选 Python 环境:点 Notebook 顶部工具栏的 Python 按钮。电脑上没装 Python 的人直接选”Vault 管理环境”,插件会自动下载独立 Python 3.12(安装包经 SHA-256 校验),不碰系统 Python、不改 PATH 和注册表。
装完先改这 4 个设置
- 设默认内核(插件设置页):之后打开的 Notebook 默认用它,不用每次手动点 Python 按钮选环境。
- 依赖检查提示方式:编辑停顿约 900 毫秒会自动扫描 import / from 语句并提示缺失模块;网络慢、提示刷屏的人可以改手动触发。搜索是精确匹配 PyPI 包名(sklearn 会映射到 scikit-learn),不是模糊搜索。
- 崩溃恢复保留天数:默认 7 天自动清理未保存草稿;跑长实验的人调长一点,硬盘宽裕就别省这点空间。
- 输出图片存哪:走 Obsidian 全局附件设置。先定好附件规则(比如统一存到指定附件文件夹),再跑会出图的 Notebook,不然图片散落各处。
常见问题
- 能在手机或平板上跑代码吗?不能。当前版本是桌面端专属,移动端只有早期版本的查看能力,别按”移动执行”来规划。
- 能连远程 Jupyter 服务器吗?不支持。执行只发生在本机 Python 环境,需要远程内核请用其他方案。
- Vault 用云同步,换台电脑跑不起来?正常。同步过去的是 .ipynb 文件,每台电脑的 Python 环境是独立的(存在各设备的 ipynb-envs/ 目录下),到新电脑上重新建一次环境就行。
- 这里存的 .ipynb,Jupyter / VS Code 能打开吗?能。标准 nbformat 4 格式,不生成伴随的 Markdown 文件,换工具直接打开继续用。
- 删包时提示不让删?这是卸载保护:Notebook 运行必需的组件、被其他包依赖的包不允许直接删,先停掉占用它的内核再说。
- 改了代码没保存电脑断电了?有崩溃恢复草稿,重启后可恢复;保存前还会检测文件是否被外部改过,防止覆盖冲突。
适合谁、不适合谁
适合:Obsidian 重度用户,日常用 Python 做数据分析、写实验记录,希望”解释文字加代码加结果”待在同一知识库里、还能被双向链接和 Dataview 索引的人。不适合:需要远程内核、移动端执行、团队统一环境的人。一句话:它是”长在 Obsidian 里的本地 Jupyter”,不是”云端 Notebook 服务”,先接受”桌面加本机”这个前提再装。
开源地址
GitHub 国内访问较慢,如打不开可多刷新几次
推广

关注「软件教程管家」
回复软件名即取即下:网盘下载链接 + 提取码,一步直达,不用再跳转。
版权与使用提示
本站资源仅供个人学习交流,请勿用于商业用途。软件与资料版权归原作者所有;如有侵权,请通过公众号「软件教程管家」联系我们,我们将在 24 小时内下架处理。查看免责声明 ›
文章推荐
标签推荐
正文完







