代码、公式与图表
笔记里不只有文字。记下一条总是忘记的命令,规规矩矩地写一个公式,或者把一个流程画成图表,都可以放在同一篇笔记里,而且全部在你的 Mac 上绘制,无需联网。
行内代码
用反引号包住简短的命令、文件名或设置项,或者选中它后按下 ⌥⌘C:
重启路由器,然后运行 `ping 1.1.1.1` 检查一下。重启路由器,然后运行 ping 1.1.1.1 检查一下。
代码块
要写多行代码,请使用代码块。按下 ⌃⌘C,或者在单独一行中输入三个反引号:Varlig 会替你补上结尾的反引号,并建议一种语言。选择一种语言,例如 python 或 swift,代码就会显示语法着色。
```python
for item in packing_list:
print(item)
```
代码块旁边的 Copy Code 按钮会拷贝其中的内容,不含反引号。反引号行会保持隐藏,除非光标位于代码块中。
有两种语言比较特别:calc 会把代码块变成计算器(请参阅你的第一个计算),mermaid 则会绘制图表,详见下文。
公式
用 TeX 记法书写数学公式。用单个美元符号包住公式,它就会留在句子当中(Format › Math Formula);把公式放在各占一行的两个双美元符号之间,它就会显示为一个公式块(Format › Math Block):
圆的面积是 $\pi r^2$。
$$
x = \frac{-b \pm \sqrt{b^2 - 4ac}}{2a}
$$
光标位于公式中时,你会看到它的源代码,并在输入时看到实时预览。Varlig 支持常用的 TeX 命令;遇到不认识的命令时,会在公式的位置显示错误。
公式只负责展示数学内容。要算出结果,请改用计算块。
Mermaid 图表
用文字描述流程图、时间线或其他图表,Varlig 就会在笔记中把它画出来。选取 Format › Mermaid Diagram 可以插入一个入门模板,你也可以直接写一个 mermaid 块:
```mermaid
flowchart LR
A[想法] --> B[计划] --> C[完成]
```
第一行指明图表的种类。Varlig 可以绘制流程图(flowchart 或 graph)、sequenceDiagram、classDiagram、stateDiagram、erDiagram、pie、gantt、journey、timeline、mindmap、gitGraph、quadrantChart、xychart、sankey、kanban 等。编辑文字,图表就会随之变化。
一个图表最多可以有 512 行、256 个框和 512 条连线。
YAML 前置元数据
有些工具会从 Markdown 文件的开头读取元数据。选取 Format › YAML Front Matter,即可在笔记的最开头添加一个位于两行 --- 之间的块:
---
project: 厨房翻新
status: 规划中
---
Varlig 会完全按你写的样子保留前置元数据,并把它之后的第一行用作笔记标题。
HTML
Varlig 会把 HTML 标签显示为文本,而不会把它们转换为格式。唯一的例外是 <br>,它会另起一行。