Skip to content
Yaogang Lian edited this page Dec 3, 2015 · 19 revisions

Quiver 是一个程序员专用的记事本应用,可轻松混合文本、代码、Markdown、LaTeX 到一个记事本中。提供强大的代码编辑功能,以及对 Markdown 和 LaTeX 的编辑和即时预览,提供全文搜索功能。

1 - 开始使用

欢迎使用 Quiver!本教程将帮助您入门。

如果你想立即开始使用 Quiver,只用记住一件事:

Quiver 的笔记是由单元格组成。

单元格可以是一段文本,代码,Markdown,或者LaTeX。一个笔记中可以混排不同类型的单元格,甚至可以给不同的代码单元格设置不同的语言。

新建一个笔记,开始键入你想写的内容。按"shift + 返回"(⇧⏎) 创建一个新的单元格,使用退格键合并单元格。只要知道这些你就可以开始使用 Quiver 了。

但如果你想要了解更多,请继续阅读。

2 - 单元格类型

目前支持五种单元格类型:

  1. 文本单元格:支持富文本编辑,图像和链接。
  2. 代码单元格:使用 ACE 代码编辑器,语法高亮显示支持 120+ 语言、 20 + 主题、 支持自动缩进、 代码自动补全,功能多多。
  3. Markdown 单元格:支持自定义 CSS,即时预览。
  4. LaTeX 单元格: 使用 MathJax 来排版笔记中的数学公式。
  5. 图表单元格:使用纯文本创建序列图和流程图。

文本单元格

text-cell-style

你可以使用工具栏按钮或键盘快捷方式更改文本格式。在"格式"菜单下可以找到所有格式设置选项和键盘快捷方式。

代码单元格

这是一个代码单元格设置为 JavaScript 模式:

void hello()
{
    console.log("Hello World!");
}

这是一个代码单元格设置为 CoffeeScript 模式:

hello = -> console.log 'Hello World!'

代码单元格支持 120 + 语言的语法高亮、 20 + 主题、 自动缩进,代码折叠,多个游标和选择、 代码自动补全、tab 触发,Vim/Emacs 键绑定等。在 Ace 代码编辑器的网站 (http://ace.c9.io/) 上,你可以读到更多 Ace 代码编辑器的功能。

Markdown 单元格

Markdown 单元格支持标准 Markdown 语法以及 GitHub Flavored Markdown (GFM)。

基本格式

# 标题 1
## 标题 2
### 标题 3
#### 标题 4
##### 标题 5
###### 标题 6

---

*斜体*, **粗体**, ~~划除~~

`内联代码`

列表

1. 第一个有序的列表项
2. 另一个列表项
  * 无序的子列表
1. 实际数字不重要
  1. 有序的子列表
4. 另一个列表项

引用

> 和平不能靠武力; 它只可以通过理解来实现。

链接

[内联式链接](https://www.google.com)
http://example.com

你可以创建链接到另一个笔记:(“笔记”菜单 -> 复制笔记链接 -> 粘贴)

[01 - Getting Started](quiver-note-url/D2A1CC36-CC97-4701-A895-EFC98EF47026)

表格

| Tables        | Are           | Cool  |
| ------------- |:-------------:| -----:|
| col 3 is      | right-aligned | $1600 |
| col 2 is      | centered      |   $12 |
| zebra stripes | are neat      |    $1 |

GFM 任务列表

- [ ] a task list item
- [ ] list syntax required
- [ ] normal **formatting**, @mentions, #1234 refs
- [ ] incomplete
- [x] completed

内联 LaTeX

您可以在 Markdown 单元格中使用内联 LaTeX,例如,$x^2$

LaTeX 单元格

使用 LaTeX 单元格可以很容易地排版数学公式。例如,

\begin{align}
  \nabla \times \vec{\mathbf{B}} -\, \frac1c\, \frac{\partial\vec{\mathbf{E}}}{\partial t} & = \frac{4\pi}{c}\vec{\mathbf{j}} \\
  \nabla \cdot \vec{\mathbf{E}} & = 4 \pi \rho \\
  \nabla \times \vec{\mathbf{E}}\, +\, \frac1c\, \frac{\partial\vec{\mathbf{B}}}{\partial t} & = \vec{\mathbf{0}} \\
  \nabla \cdot \vec{\mathbf{B}} & = 0
\end{align}

预览如下:

latex-cell-rendered

也可以在句中使用 LaTeX,例如,$x^2$

您还可以在设置中添加自定义宏。添加的自定义宏可以在所有的 LaTeX 单元格中使用。

图表单元格

使用图标单元格可以很方便地创建序列图和流程图。

请参照这里的语法:

序列图示例:

Title: Here is a title
A->B: Normal line
B-->C: Dashed line
C->>D: Open arrow
D-->>A: Dashed open arrow

预览如下:

sequence-diagram-rendered

流程图示例:

st=>start: Start:>http://www.google.com[blank]
e=>end:>http://www.google.com
op1=>operation: My Operation
sub1=>subroutine: My Subroutine
cond=>condition: Yes
or No?:>http://www.google.com
io=>inputoutput: catch something...

st->op1->cond
cond(yes)->io->e
cond(no)->sub1(right)->op1

预览如下:

flowchart-rendered

3 - 单元格操作

单元格操作很容易上手,但其实功能强大。

其中最重要的一个操作你已经学会了:按"shift + 返回"(⇧⏎) 来创建一个新的单元格。默认情况下新建的单元格是一个文本单元格,但你可以轻松地将其转换为其它类型的单元格。

转换单元格类型有好几种方法:你可以使用工具栏上的下拉菜单,或者键盘快捷方式 (⌥⌘1 转换为文本单元格,⌥⌘2 转换为代码单元格,⌥⌘3 转换为 Markdown 单元格,⌥⌘4 转换为 LaTeX 单元格,⌥⌘5 转换为图表单元格)。这些快捷方式可以在“单元格”菜单下找到。

另一个重要的操作是如何合并两个单元格。只需将光标放在第二个单元格的开头,然后按回退键。请注意不同类型的单元格不能合并。

有时候你可能想在当前光标位置添加一个新的单元格。你可以用“单元格”菜单下的 "New Cell At Cursor" (⇧⌘I) 菜单项实现。

你还可以剪切、复制或粘贴单元格,拆分单元格,向上或向下移动单元格。所有这些单元格操作和其相应的键盘快捷方式可以在“单元格”菜单下找到。

4 - 图像、 文件和链接

你可以拖拽或粘贴图像到文本单元格中。你也可以使用工具栏中的“插入图像”按钮

插入的图像自动复制到当前笔记的资源文件夹中,因此即使原始图像被删除,笔记中的图像也照样可以使用。

如果将一个文件 (例如,PDF、 zip、 源文件) 拖拽到文本单元格中,你可以选择将它复制到资源文件夹,或者保存为链接。您也可以使用工具栏中的“附加文件”按钮。

如果粘贴的文本中有 URL,Quiver 会自动将其转换为链接,比如 http://www.apple.com

另一个有用的功能是笔记链接。您可以使用“笔记”菜单下的菜单项"复制笔记链接"(⌃⌥⌘C)来复制当前笔记的链接,例如:

02 - Cell Types

03 - Cell Operations

这样你可以很方便地交叉引用你的笔记。不同笔记本中的笔记也可以相互链接。

笔记链接在 Markdown 单元格中也可以使用。在“笔记”菜单下使用菜单项“复制笔记链接”(⌃⌥⌘C),然后粘贴到 Markdown 单元格。例如:

[02 - Cell Types](quiver-note-url/9686AA1A-A5E9-41FF-9260-C3E0D0E9D4CB)

它在预览或演示模式中会变成笔记链接。

5 - 预览和演示模式

即时预览

Quiver 支持 Markdown 和 LaTeX 的即时预览。你可以切换到同时显示编辑器和预览的双栏模式 (⌘6)。

你也可以双击列表中的笔记在新窗口打开,然后切换到双栏模式。例如:

当您在编辑器中进行更改时,预览会实时更新。

默认情况下,编辑器和预览之间会同步滚动。但您可以在视图菜单中关闭此功能。

演示模式

Quiver 还支持全屏幕演示模式。您可以从“笔记”菜单中选择“启动演示”(⌃⌥⌘P),或单击笔记右下角的“演示”按钮。

演示模式非常适合教室使用、 团队会议、 演示或者自己复习笔记。

在演示模式中,你可以使用左/右箭头键来移动到列表中的上个/下个笔记。

6 - 全文搜索

笔记再好,不能快速找到也没用。Quiver 的全文搜索是基于苹果操作系统中 Spotlight 使用的底层工具:Search Kit。因此 Quiver 可以瞬间搜索数以千计的笔记。

若要搜索所有的笔记,请单击右上角的搜索按钮。你可以通过关键字、 标题或 #标签 搜索。

你也可以在一个笔记本中搜索。首先打开笔记本,在列表底部的搜索框中输入关键字或 #标签。这也是全文搜索,不过只显示当前笔记本中的搜索结果。

如果你想在一个笔记中查找关键词,请使用 ⌘F。你会看到一个查找工具栏:

使用 ⌘G (或回车键) 跳转到下一个搜索结果。用 ⇧⌘G (或 shift + 回车)向上查找。

查找工具栏在编辑器和预览中都可以使用。

7 - 标签

Quiver 支持给笔记加标签。这是又一种整理笔记的方式。

你可以按标签分类来浏览笔记:

如果你从列表中同时选择多个笔记,你可以同时给他们添加或删除标签。