笔记

用块编辑器书写工作区笔记:用 / 插入块、绘制 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(与上方块并排)。
  • 选中文本会显示格式工具栏:粗体、斜体、下划线、删除线、行内代码,以及颜色与高亮。

块菜单

分组块
CommonTask list、Bulleted list、Heading 1、Quote、Code block、Table
Basic blocksParagraph、Heading 1–4、Bulleted list、Numbered list、Task list、Quote、Callout、Code block、Divider
More blocksToggle list、Toggle heading 1–3、Content tabs、Button、Table 及其行 / 列操作、Contents、Block equation、Inline math、Link、Bookmark
Columns2、3、4 或 5 列
MediaImage、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 或 MonoDefault
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、WebP25 MB
视频MP4、WebM100 MB
音频MP3、WAV、OGG、FLAC、M4A100 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 或更早版本。文件位置见隐私与数据。

相关