笔记
用块编辑器书写工作区笔记:用 / 插入块、绘制 Mermaid 图、添加附件、把代码发送到终端,以及导入或导出 Notion Markdown。
每个工作区有一篇笔记:一份块编辑器文档,用于记录属于该任务的计划、发现、命令与上下文。它保存在本地,并自动保存。
块编辑器笔记在 0.5.5 推出,Mermaid 图在 0.6.0 推出。两者目前仅限 Windows;0.5.3 的 macOS 与 Linux 构建仍是早期的 Markdown 笔记本。
打开笔记
- 选择工作区标题栏的 Notes,或按 Focus notes(
Cmd/Ctrl+→)。 - 笔记以面板形式在工作区画布中打开。面板是否打开会随工作区一同记住。
编辑器的界面文字为英文。
用块书写
空笔记会提示 Type / for blocks, or paste Markdown。
- 输入
/打开块菜单,继续输入即可筛选。菜单也能匹配中文块名与拼音。 - 粘贴 Markdown 会转换为块。
- 悬停在块上会显示其手柄:Drag to move · Click for block actions(拖动以移动 · 点击打开块操作)。块操作包括 Turn into、Duplicate、Move up、Move down、Delete 与 Side by side with the block above(与上方块并排)。
- 选中文本会显示格式工具栏:粗体、斜体、下划线、删除线、行内代码,以及颜色与高亮。
块菜单
| 分组 | 块 |
|---|---|
| Common | Task list、Bulleted list、Heading 1、Quote、Code block、Table |
| Basic blocks | Paragraph、Heading 1–4、Bulleted list、Numbered list、Task list、Quote、Callout、Code block、Divider |
| More blocks | Toggle list、Toggle heading 1–3、Content tabs、Button、Table 及其行 / 列操作、Contents、Block equation、Inline math、Link、Bookmark |
| Columns | 2、3、4 或 5 列 |
| Media | Image、Video、Audio、File |
Contents 会插入目录块。公式使用 TeX,每个公式最多 2,000 个字符。
笔记快捷键
Mod 在 Windows 与 Linux 上是 Ctrl,在 macOS 上是 Cmd。
| 操作 | 默认 |
|---|---|
| 粗体 / 斜体 / 下划线 | Mod+B / Mod+I / Mod+U |
| 删除线 | Mod+Shift+S |
| 行内代码 | Mod+E |
| 高亮 | Mod+Shift+H |
| 链接 | Mod+Shift+K |
| 块操作菜单 | Mod+/ |
| 移到格式工具栏 | Alt+F10 |
| 复制块 | Mod+Shift+D |
| 删除块 | Mod+Shift+Backspace |
| 上移 / 下移块 | Alt+Shift+↑ / Alt+Shift+↓ |
| 展开或折叠开关块、勾选任务、离开代码块 | Mod+Enter |
| 把代码块发送到终端 | Mod+Shift+Enter |
| 转换为段落 / 一至三级标题 | Mod+Alt+0 / Mod+Alt+1–3 |
| 转换为任务 / 无序 / 有序列表 | Mod+Alt+4 / 5 / 6 |
| 转换为开关块 / 代码块 / 引用 | Mod+Alt+7 / 8 / 9 |
在 Windows 上,重做是 Ctrl+Y,因为 Ctrl+Shift+Z 仍是 Zen 模式。Cmd/Ctrl+S 会立即保存笔记。以上快捷键都可在设置 → 快捷键(Settings → Shortcuts)的 Notes 分组中修改。
笔记选项
笔记面板上的 Note options(⋯)菜单中,每个选项都会立即生效:
| 选项 | 默认 |
|---|---|
| 字体样式:Default、Serif 或 Mono | Default |
| Small text(小字号) | 关 |
| Full width(全宽) | 关 |
| Table of contents(目录) | 开 |
| Import… | Notion 导出(.zip)或 Markdown |
| Export… | Notion Markdown(.zip) |
开启 Table of contents 且至少有两个标题时,笔记边缘会出现浮动大纲。悬停或聚焦它会列出标题;选择一项即可滚动到该标题。面板较窄时它会隐藏。
笔记的基础字号在设置 → 外观 → 笔记字号(Settings → Appearance → Note font)中设置(默认 14)。
代码块与图表
- 代码块带有语言按钮、Copy 与 Send。
- 语言为 Mermaid 的代码块会绘制其图表。它的 Diagram view 切换有 Code、Preview 与 Split;新图表默认为 Split。如果图表渲染器无法加载,则显示源码。
发送到终端
Send(或 Mod+Shift+Enter)会把代码粘贴到工作区的终端标签页。提示信息会写出目标标签页,按钮随后显示 Sent。
- 代码只会被粘贴,永远不会被执行。单行代码会去掉末尾换行,因此不会有回车到达程序。
- 多行代码只有在程序开启了括号粘贴(bracketed paste)时才会发送;否则会被拒绝,因为
cmd.exe之类的程序会逐行执行。此时可选择 Paste first line 或 Copy instead。 - 含控制字符的代码不会发送。
- 如果工作区没有打开的终端,或其程序已退出,发送会被拒绝并给出提示。
链接
- 链接必须以
http://或https://开头,且不含用户名或密码。 Ctrl/Cmd+点击链接会在工作区的 Browser 面板中打开。再加Shift则在系统浏览器中打开。
附件
从块菜单的 Media 分组插入媒体,然后选择文件。附件会被复制到该笔记自己的文件夹中,位于你的仓库之外。
| 类型 | 格式 | 单个上限 |
|---|---|---|
| 图片 | PNG、JPEG、WebP | 25 MB |
| 视频 | MP4、WebM | 100 MB |
| 音频 | MP3、WAV、OGG、FLAC、M4A | 100 MB |
| 文件 | 其他文件 | 100 MB |
文件块提供 Open 与 Show in folder。找不到的附件会显示为缺失。
导入与导出
- Export… 会把笔记连同附件保存为 Notion Markdown 布局的
.zip。Cordy 会先保存笔记。命令面板中的 Export note for Notion… 作用相同。 - Import… 读取 Notion 导出的
.zip或 Markdown 文件,并追加到当前打开笔记的末尾,作为可撤销的一步。笔记面板打开时,命令面板会提供 Import into note…。 - 导入会跳过 Notion 数据库,把正文中链接的文件保留为文本,并略去找不到的附件。Cordy 会报告略去了哪些内容。
- 如果导入会让笔记超出上限,则不会添加任何内容。
保存与上限
- 停止输入 800 毫秒后,笔记会自动保存。
- 一篇笔记最多容纳 1,100,000 个字符和 150,000 个元素。超出上限时笔记不会保存:你的编辑仍留在屏幕上,提示会说明超出多少,Show what's over the limit 可带你定位。回到上限以内后会再次保存。
- 过大的粘贴会被截断以适配,并提供 Undo paste 操作。
从 Markdown 笔记转换
0.5.5 会在首次启动时把已有的 Markdown 笔记转换为块格式。每份原件都作为备份保留在转换后的笔记旁边,且不会被删除。转换后不支持退回 0.5.4 或更早版本。文件位置见隐私与数据。