如何将 marimo 笔记本导出为静态 HTML 并用 --watch 自动重新导出【免费下载链接】marimoA reactive notebook for Python — run reproducible experiments, query with SQL, execute as a script, deploy as an app, and version with git. Stored as pure Python. All in a modern, AI-native editor.项目地址: https://gitcode.com/GitHub_Trending/ma/marimomarimo 笔记本保存为纯 Python 文件如果你需要一份不带交互的 HTML 快照——比如归档、发给人离线查看——可以用marimo export html命令完成。这条命令会先运行笔记本生成可视化输出再保存为 HTML。本文介绍一次性导出以及如何用--watch让 HTML 在笔记本文件变化后自动重新导出。前提已按安装指南安装 marimopip、uv、conda 等途径并且当前环境能正常运行目标笔记本。一次性导出为静态 HTML基本命令marimo export html notebook.py -o notebook.html把notebook.py换成你的笔记本文件名。导出行为有几点需要知道导出会执行笔记本marimo 先运行笔记本以生成可视化输出再保存为 HTML因此环境里要装好笔记本依赖。-o缺省时打印到终端不提供--output时HTML 内容会输出到 stdout 而不是写入文件。覆盖已有文件输出文件已存在时一次性导出会提示是否覆盖用-f/--force跳过确认直接覆盖。向笔记本传递 CLI 参数用--分隔例如marimo export html notebook.py -o notebook.html -- -arg1 foo -arg2 bar。导出成功后用浏览器打开生成的notebook.html即可看到文档和输出。若笔记本配置了 slides 布局生成的是 HTML reveal.js 幻灯片会保留幻灯片结构、演讲者备注嵌入 HTML 中任何收到文件的人都可以看到和幻灯片设置。用 --watch 自动重新导出笔记本还在频繁修改时加上--watchmarimo 会监视笔记本文件磁盘上每次变化都自动重新导出marimo export html notebook.py -o notebook.html --watch约束与行为--watch必须配合-o不提供输出文件时会报Cannot use --watch without providing an output file with --output.命令不会启动。监视启动后终端会显示Watching notebook.py for changes...文件变化时打印File ... changed. Re-exporting to notebook.html并重新执行导出、覆盖输出文件。watch 模式下重新导出会直接覆盖输出文件不做覆盖确认。该命令会持续运行按 CtrlC 中断即停止监视。可选导出中隐藏代码默认导出包含笔记本代码--include-code默认开启。如果只要输出和文档、不暴露代码加上--no-include-codemarimo export html --no-include-code notebook.py -o notebook.html --watch如何判断导出是否成功文档给出的判断依据是退出状态码单元格出错时状态码非零导出过程中任何单元格报错命令会以非零状态码结束。但 HTML 结果可能仍然生成错误会包含在输出页面里一次性模式下会提示Export was successful, but some cells failed to execute.watch 模式下每次重导同样出错时打印同样的警告并继续监视。如果脚本化流程允许单元格报错可在命令后追加|| true例如marimo export html notebook.py || true。watch 模式下每次重导出后检查终端是否打印Re-exporting to ...以及输出 HTML 文件的时间戳是否更新即可确认自动重新导出在工作。其他导出路径可选从编辑器导出在 marimo 编辑器的笔记本菜单里可直接把当前视图下载为静态 HTML还可以为单个笔记本配置自动保存 HTML 快照快照存放在笔记本目录下的__marimo__文件夹中。预渲染 HTML静态导出在浏览器运行时才执行 JavaScript 渲染源码为 HTML。如果需要直接提供渲染好的 HTML官方文档给出了一个基于 playwright 的后处理脚本它调用playwright install chromium-headless-shell下载无头浏览器需要网络下载与写入权限再用 Chromium 打开导出的 HTML 并把渲染结果写为新文件。仅在你确实需要直接服务 HTML时才走这条分支。完整的格式对照PDF、ipynb、Markdown、WebAssembly HTML 等见导出指南索引marimo export html的参数细节可参考 导出命令实现。【免费下载链接】marimoA reactive notebook for Python — run reproducible experiments, query with SQL, execute as a script, deploy as an app, and version with git. Stored as pure Python. All in a modern, AI-native editor.项目地址: https://gitcode.com/GitHub_Trending/ma/marimo创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考