资讯 · 改写稿

会「跑」的 Markdown 笔记:Ledge 把命令和 AI 提示词放回笔记里

结论先给:Ledge 把「笔记」和「终端」缝在一起——代码块不再只是死文本,按一下快捷键就能运行,输出直接留在笔记里。对习惯把命令记进 Markdown 的人来说,这省掉了复制到终端、再把结果贴回来的一步。

来源(Ledge 官网,2026-09-29 登上 Hacker News 的 Show HN)给自己的定位是「会跑的 Markdown 笔记」(Runnable Markdown notes):写一条笔记,在代码块上按 ⌘↩,它的输出就会流式显示在代码块下方;运行位置可以是你的 shell、你的项目、你的机器,或者一台服务器。

它把哪些东西做成「可运行」

来源的示例很有代表性:一条笔记里先用 shell 拉数据、再用 Python 汇总、再用 SQL 交叉验证、最后用一段 prompt 把结果写成给团队看的更新——四步都在同一页笔记里完成,输出按顺序留在各自代码块下面。

密钥怎么放

来源用 profile 来管理这类信息:笔记里声明用哪个 profile,由 profile 持有 API key 与数据库地址,命令再引用它(示例是 $STRIPE_KEY)。这样笔记本身不必写死凭据,换环境时改 profile 即可。对「把命令写进笔记、又不想把密钥散落在正文里」的人来说,这是个实用的分界。

本站实测——这套「文档即操作台」的思路,和站内介绍过的其他工具正好互补:Docker Agent 把 Agent 定义成可版本化的 YAML,而 Ledge 把可执行的命令留在笔记里;两者的共同点都是「把做过的事变成可复现的文本」,区别是前者面向 Agent、后者面向人。若你的日常是「查数据、记结论」,把两者叠起来,笔记可以既存命令又存结论。

来源称 Ledge 覆盖 macOS(Apple Silicon)、Windows 与 Linux,并提供了移动端(iPhone 与 iPad 的 App Store、以及 Android Beta)。也就是说,命令在桌面跑,结论可以在手机上回看。

它和「可执行笔记」这一类差在哪

可执行笔记不是新概念,早就有工具让代码块能跑。Ledge 的不同在于载体是 Markdown、运行位置是你的真实环境:shell 与 SQL 块直接在项目目录或服务器上执行,AI 提示词块也能就地调用模型。换句话说,它服务的是「把日常命令与结论记在一起」的开发者,而不是把笔记当实验台的人。

容易踩的坑

在笔记里写死密钥:来源建议用 profile 持有凭据,正文只做引用。

把可执行笔记当沙箱:命令跑在你的真实环境或服务器上,权限要自己把控。

什么都做成可运行:只把需要复现的命令与结论留下即可。

常见问题

Ledge 是什么?

来源称它是一款可执行的 Markdown 笔记应用:在代码块上按 ⌘↩ 运行,输出流式显示在下方,可在本机、项目或服务器上执行。

它能运行什么?

来源示例包括 shell 命令、代码(如 Python)、SQL 查询与 AI 提示词。

密钥怎么管理?

来源用 profile 持有 API key 与数据库地址,笔记通过引用使用,不必把凭据写进正文。

支持哪些平台?

来源称支持 macOS(Apple Silicon)、Windows、Linux,并提供 iPhone/iPad 与 Android Beta 移动端。

来源参考

以上为外部来源;本文为 RefHub 用自己的结构重写,事实以来源页为准,价格与政策会变,请回源核对当日。

下一步:把 Agent 定义成配置,读 Docker Agent 的声明式做法;Agent 之间怎么分工,见 Agent 配置同步。