使用 Ornata。

Ornata 支持 macOS 12 或更高版本（Apple 芯片）和 64 位 Windows 10 或更高版本。在 Windows 上，文档里的 ⌘ 对应 Ctrl，⌥ 对应 Alt。从首页下载并打开应用。第一次启动时，选择 创建新仓库 为笔记新建一个文件夹，或选择 打开现有仓库 使用你已有的 Markdown 文件夹 —— 包括 Obsidian 的。

按 ⌘N 新建笔记，输入标题，开始写。停下输入片刻后会自动保存，没有保存按钮。

随时按 ⌘K 跳转到某篇笔记或执行命令。这一个快捷键几乎能带你去任何地方。

笔记库就是一个文件夹：

my-vault/
├── notes/       你的笔记 —— 真实文件夹里的普通 .md 文件
└── .ornata/     应用数据：粘贴的图片、笔记历史、模板

• 笔记的 文件名就是它的标题，没有任何 ID。重命名笔记就是重命名文件，所有指向它的链接都会被改写。
• 你可以用其他编辑器编辑同样的文件。Ornata 会在外部改动发生时、以及你切回它时发现这些改动。如果某篇笔记里有尚未保存的输入，以你的输入为准。
• 其他工具写入的 frontmatter 会原样保留，并以只读的「属性」面板显示在笔记上方。Ornata 自己从不写 frontmatter。
• 删除笔记会把它移到废纸篓。Ornata 没有内置同步；因为笔记就是文件，iCloud 云盘、Dropbox 或 git 的用法与任何文件夹一样。
• 用 ⌘O 打开任意位置的 Markdown 文件。它像普通笔记一样在标签页里打开，但不会被复制进笔记库。
• 在「设置 → 仓库」里更换当前打开的笔记库。

边打字边 Markdown

在行首输入常见的 Markdown 写法，会自动变成对应的格式：

建议菜单

在任意一行输入 /，或点击空行左侧出现的 +，打开建议菜单：标题、列表、引用、表格、分隔线，以及指向其他笔记的链接。继续输入可缩小范围。输入 /code 可按语言选择代码块 —— 约三十种，外加 Mermaid。

输入 @ 可插入指向今天、明天或昨天 日记 的链接。

链接与图片

• 用 /link 链接到另一篇笔记，或输入 [[ 加标题。Ornata 会把它存成标准的 Markdown 链接 [标题]（文件夹/笔记.md），所以在其他应用里也能用。指向标题的链接形如 笔记.md#标题。
• 指向尚不存在的笔记的链接显示为灰色虚线；点击它会创建这篇笔记。
• 把图片粘贴或拖进笔记，会保存到 .ornata/assets/。你也可以在「设置 → 图片」里改用自己的上传命令，例如 PicGo。

代码、公式与图表

• 代码块带语法高亮和复制按钮。点击语言标签可以选中整个代码块、复制、折叠或更改语言。悬停在代码块上，可用边栏的箭头折叠某个函数或分支；折叠只改变显示，复制时仍会复制全部内容。
• 用 $x^2$ 写行内公式，或用单独一行的 $$ ... $$ 写块级公式（KaTeX）。
• 语言为 mermaid 的代码块会渲染成图表；点击它可查看并编辑源码。

在笔记里移动

• 每个标题左侧有一个小箭头，可折叠它的内容。较长的笔记右侧边缘还有大纲。
• ⌥↑ 和 ⌥↓ 移动当前块，或在同级列表项之间移动当前项。撤销一次就能放回原处。
• ⌘F 在笔记内查找；⌘⌥F 加上替换。
• 右上角的 </> 按钮可在编辑器和原始 Markdown 之间切换。
• ⌘⇧F 是专注模式：侧边栏和各个栏会淡出，直到你把鼠标移过去。

• 笔记底部的 链接提及 列出链接到它的笔记，并附上链接所在的那一行作为上下文。未链接的提及 显示其他笔记里提到了它的标题却没有链接的地方；点「链接」即可把它变成链接。
• 其下方的小型 局部图谱 显示这篇笔记和它的邻居。
• 从命令面板（⌘K → 关系图谱）把整个笔记库作为图谱打开。文件夹形成彩色区域，悬停一篇笔记会描出它的链接和方向，也可以搜索并飞到某篇笔记。
• 标签读取自笔记正文里的 #标签，以及 frontmatter 里的 tags: 行。边栏里的 # 按钮会列出它们和数量。

每篇打开的笔记是一个标签页。⌘W 关闭当前标签；标签页的菜单里有批量关闭选项。重启后，你打开的标签会恢复。

分屏

• 从命令面板按 ⌘↵、从标签页或文件的菜单，或 ⌘ 点击链接，都能把笔记 在侧边打开。窗格最多四个，取决于窗口宽度。
• 每个窗格有自己的标题栏 —— 自己的前进后退箭头、面包屑和操作。窗格菜单（分栏图标）可以拆分、与下一个窗格交换，并列出已打开的窗格。
• 拖动分隔条调整大小。新增或关闭窗格后，宽度会重新均分。
• ⌘1–⌘4 跳到对应窗格，⌘. 切到下一个，⌘⇧\ 拆分当前窗格。
• 布局、各窗格宽度和每个窗格的浏览轨迹在重启后都会恢复。

后退与前进

⌘[ 和 ⌘] 沿着窗格显示过的笔记后退和前进。每个窗格都有自己的轨迹，所以箭头只移动它所在的窗格；如果某一步会落到已在另一个窗格里打开的笔记上，就会跳过。

• ⌘K 同时搜索标题和内容。标题匹配排在前面，并且支持缩写：prjroad 能找到「project roadmap」。选择内容匹配会滚动到对应位置。没输入搜索词时，面板会列出最近的笔记和所有操作。
• 边栏可以按名称或修改时间排序（「笔记」标题上的按钮）。在右键菜单里置顶一篇笔记，它就留在最上面。
• 底部的栏会显示当前视图最相关的快捷键。可从命令面板隐藏（显示或隐藏快捷键栏）。

• ⌘J 打开今天的笔记，例如 journal/2026-10-18.md，没有就创建。想让每天从模板开始，保存一个名为 daily 的模板（见下）。
• 快速记录：⌘⌥J 在任何应用里都可用。会弹出一个小框，输入一行并按回车，就带着时间追加到 Inbox.md。
• 待办：任何 - [ ] 行（或 * 加空格）都是待办。边栏的「任务」行会按笔记分组列出整个笔记库里所有未完成的待办；在那里勾选，所在笔记里就同步完成。
• 模板：在命令面板里可以把笔记存为模板、从模板新建笔记，或打开模板文件夹（.ornata/templates）。

• Ornata 会在笔记变化时保留它的快照。右下角的时钟打开笔记历史：选一个快照与当前文本对比，需要时恢复它。
• 时间久了，粘贴的图片可能不再被引用。⌘K → 清理图片会列出没有任何笔记引用的图片，并把它们移到废纸篓，你仍可以找回。

笔记右上角的 ··· 菜单里有：

• PDF —— 带由标题生成的书签目录。纸张大小（A4、Letter、A5）和页边距在「设置 → 导出」里选。完成后，「在 Finder 中显示」（Windows 上是文件资源管理器）会带你到该文件。
• HTML —— 一个独立的页面。
• Markdown、复制为富文本 和 复制 Markdown。

Ornata 支持 MCP —— AI 智能体用来调用工具的开放标准。智能体可以搜索和读取你的笔记，查看反向链接和未完成待办，并且 —— 只有你允许时 —— 新建、编辑、追加、勾选待办、重命名、移动和删除。

连接智能体

• 点击状态栏的插头图标（或 ⌘K → MCP 设置）。服务开启或有智能体连接时它是绿色的。
• 点 连接 在你的电脑上启动服务。选择你的智能体对应的标签页并复制那一行，例如：

  claude mcp add ornata --transport http http://127.0.0.1:13200/mcp \
    --header "Authorization: Bearer <你的令牌>"

• Claude Code、Gemini CLI、Cursor 和 VS Code 连接的是这个服务，所以 Ornata 必须开着。Codex 和 Claude Desktop 通过 stdio 自己启动 Ornata,Ornata 关着也能用。其他任何 MCP 客户端可以使用「其他」标签页里的 URL 和请求头。

智能体能做什么

你可以按笔记库在 MCP 设置（或「设置 → 智能体」）里选择：

这个级别只能在 Ornata 里设置，智能体自己的启动选项只能把它调低。智能体只能看到真正位于笔记库内的笔记 —— 指向别处的符号链接会被忽略。发给本地服务的每个请求都带访问令牌；如果泄露了，点「重新生成」换一个新的（用旧令牌配置的智能体需要换成新的那一行）。

同时能运行 shell 命令的智能体，可以编辑你能编辑的任何文件，包括 Ornata 的设置。访问级别只约束通过这些工具工作的智能体 —— 给能运行 shell 的智能体的信任，应与你给一个坐在你键盘前的人的信任相当。

命令行

在 MCP 面板里安装 ornata 命令（它会链接到 ~/.local/bin）。同样的级别同样适用。

ornata search "roadmap"
ornata read projects/roadmap.md
ornata tasks
echo "ship it" | ornata journal add     # 追加到今天的笔记
ornata capture "buy milk"                # 在 Inbox.md 里记一行带时间的内容
ornata help

同样的列表也在「设置 → 快捷键」里。在 Windows 上，⌘ 对应 Ctrl，⌥ 对应 Alt。

• 通用 —— 界面语言（English 或简体中文）和应用版本。
• 外观 —— 浅色、深色，或跟随系统。
• 编辑器 —— 大纲提示音和动画光标。
• 图像 —— 把粘贴的图片保存在笔记库里，或运行你自己的上传命令。
• 导出 —— PDF 纸张大小和页边距。
• 仓库 —— 当前打开的是哪个文件夹，以及更换它。
• 智能体 (MCP) —— 外部智能体可以做什么，以及如何连接它们。
• 快捷键 和 更新 —— 快捷键列表，以及检查新版本。Ornata 通过签名的更新源自行更新；有新版本就绪时，边栏会提示「重启以更新」。

在别处所做的修改没有显示

Ornata 会监视笔记库，并在笔记在磁盘上改变时重新加载它 —— 除非你在其中有尚未保存的输入，那种情况下总是以你的输入为准。切到别的窗口再切回来，可以强制检查一次。

智能体连不上，或返回 401

• 检查插头是否为绿色：服务必须已连接，并且访问级别不能是「关闭」。
• 401 表示令牌缺失或已过期。请重新从 MCP 设置里复制那一行（先把智能体里旧的服务移除）—— 每次点「重新生成」，令牌都会变。
• 如果 13200 端口被占用，Ornata 会改用下一个空闲端口；设置命令里总会显示正在使用的端口。
• 智能体说某个工具不存在：访问级别太低。在 MCP 设置里调高，下一次调用就会生效。

某个链接是灰色虚线

它指向的笔记不存在。点击它会创建这篇笔记，或者修正链接。在 Ornata 内重命名笔记会替你改写链接；在 Finder 或文件资源管理器里重命名文件则不会。

重启后一切似乎都不在原来的位置

Ornata 会恢复你的标签页、分屏布局，以及每个窗格的前进后退轨迹。期间被删除的笔记会被略过。这些都不会改动你的笔记本身。

还是不行？这些文件是你笔记库文件夹里的普通 Markdown，永远属于你。可以看看 常见问题，或在 更新日志 里看看改了什么。

ornata