直接在页面中运行 25 种语言的代码。

住在页面里的代码

像在 GitHub 或 Obsidian 中那样，写一个注明语言的围栏代码块。在阅读视图或分屏视图中，它会变成带“运行”按钮的单元格。代码保留在页面的 Markdown 中，因此页面始终便于迁移；单元格打印的内容、返回的表格和绘制的图表都随页面保存，重新打开时依然都在。

```python
import pandas as pd
runs = pd.DataFrame({"month": ["Jan", "Feb", "Mar"], "km": [42, 51, 63]})
runs.describe()
```

25 种语言，都在你的设备上

JavaScript, TypeScript, Python, SQL, Lua, Shell (emulated), Ruby, PHP, R, Perl, Go, Rust, C, C++, OCaml, Haskell, Zig, C#, F#, Java, Clojure, Elixir, Erlang, Scheme, Prolog。

每种语言在你第一次运行时下载（从 Lua 或 JavaScript 的几百 KB，到 Rust 的几十 MB 不等），之后即可离线使用。“设置 → 代码运行时”可以提前把它们下载好，方便在飞机和火车上使用。

代码在沙盒框架中运行，每个页面的每种语言各有一个 worker。它无法读取应用、你的其他页面或网络：除非你为该页面允许联网，否则单元格无法访问网络。

像笔记本一样工作

• 全部运行、运行上方或下方的单元格、重启运行时并重新运行全部，以及清除输出。
• 从单元格菜单插入、移动和删除单元格，每一步都可以撤销。单元格移动时，输出会跟着走。
• 停止会中断正在运行的单元格并保留其变量；如果代码在 3 秒内没有停下，运行时会被重启。每次运行都有时间限制。
• 变量列出你的代码生成的每个值，附带类型和摘要。
• 解释与修复：可选的设备端助手会解释单元格，或建议一个修复，以差异对比的形式由你接受或拒绝。

在语言之间共享数据

同一页面中的单元格可以跨语言互相传递数据：在一个单元格里用 share(name, value)，在另一个里用 use(name)。表格传过去仍是表格：从 JavaScript 共享行数据，再用 SQL 查询。

```js
share("runs", [{ month: "Jan", n: 4 }, { month: "Feb", n: 7 }])
```

```sql
select sum(n) as total from runs;
```

输入、文件和软件包

• 单元格可以请求输入（input()、prompt()、readline），并在页面中等待你回答。
• 附加到页面的文件可以直接按名称使用：pd.read_csv("sales.csv")。单元格写出的文件可以保存到页面或下载。
• Python 自带 NumPy、pandas、SciPy、scikit-learn、matplotlib、Altair、DuckDB 等，离线可用；为该页面允许联网后，%pip install 可以添加其他软件包。

在 Vellum 中运行你的第一个代码单元格

1. 打开一个页面

   新建一个页面，或打开任何已有的页面。

2. 写一个代码块

   输入三个反引号和语言名称，例如 ```python，然后写代码，最后再输入三个反引号结束。

3. 运行它

   切换到阅读视图或分屏视图，在单元格上按“运行”（或在单元格编辑器中按 Shift+Enter）。第一次运行时会下载该语言。

4. 保留结果

   输出会随页面保存。打开单元格菜单，可以使用“全部运行”“变量”和其他笔记本命令。

在应用中

• 在页面中运行代码 Python、JavaScript、R、SQL 等 20 多种语言，在这台设备上运行。
• 变量 查看代码生成的每一个值。
• 在语言之间共享 在 JavaScript 中 share() 一个表格，在 SQL 中查询它。
• 输入、文件与图表 单元格可以提问、读取你的文件、绘制图表。
• 网络与软件包 只有在你允许后，单元格才能访问网络或安装软件包。
• 像笔记本一样工作 全部运行、运行上方或下方、移动和重启单元格。
• 解释与修复 设备端助手会解释代码并给出修复建议。
• 离线使用语言 提前下载语言，在飞机和火车上也能用。

常见问题