使用手册写作03

入图片、表格、公式与图

文档里除了字之外的东西。每一样都能拖进来或者两下点出来,而且都落在你自己的文件夹里。

先记一条

下面每一样都能从三个地方进来:快捷键、空行上打 「/」、 或者右键 → 插入。想不起快捷键就打「/」,一定找得到。

图片

放进来——三选一:

  • :从访达里把图片拖到纸面上,落在你松手的地方。一次拖好几张也行,各占一行。
  • :截图之后直接 ⌘V
  • ⌃⌘I,或者「/」菜单里的「图片」。

放进来之后——鼠标停在图上,右下角有一个把手,拖它改宽度; 宽度会写进文档里(![说明|420](img/照片.jpg) 里那个数字),换台机器打开还是这么宽。 图上还有一颗「查看」,点它在新标签页里放大看。

它在磁盘上——图片会被拷贝到这篇文档旁边的 img/ 文件夹里, 文件名保持原样(截图这种没名字的会得到一个带时间的名字)。折镜不上传、不转存、不改名, 所以整个文件夹拷给别人,图还在。

普通链接:选中一段文字按 ⌘K,把网址填进去。

指向自己库里的另一篇:直接写两个方括号,[[文档名]]。 文档名就是那个文件的名字(不带 .md)。想显示成别的字:[[文档名|显示的字]]; 想跳到那一篇的某个小节:[[文档名#小节标题]]

这么写的好处在反方向:被指向的那一篇能看见「谁提到了我」。打开提及面板(⌃⌘2)就是那张表,连在第几行都列着。 详见文档库那一篇

嵌图片也能用双链写法![[照片.png]],加宽度就是![[照片.png|300]]

表格

放进来⌥⌘T,或者「/」菜单里的「表格」。另外,从 Excel、Numbers 或网页上复制一块表格,直接粘进来就是一张排好的 Markdown 表。

:折镜里的表格是一张真表格,直接在格子里打字,不弹窗、不是只读的图。

  • 去下一个格子,⇧⇥ 回上一个, 去下一行同一列。
  • 鼠标停在表格边上会冒出行、列的把手:插入、移动、删除都在那儿点。
  • 右键表格有整套菜单;常用的几个也有键:⌘↩ 在下方插入一行,⌥⌘→ 在右侧插入一列,⇧⌘⌫ 删除该行,⌥⌘⌫ 删除该列。
  • 整列对齐:⌥⌘L 左、⌥⌘E 中、⌥⌘R 右。

代码块

⌥⌘C 起一个代码块,或者「/」菜单里的「代码块」;也可以老实打三个反引号。 块的左上角写着语言名,点它就能改——弹出的列表可以直接搜(打 py 找到 Python)。 选对语言,配色才对得上。

要在一句话中间插一小段代码,用行内代码 ⇧⌘`,写进文件是一对反引号。

数学公式

折镜用 KaTeX 渲染 LaTeX。行内公式写在一对美元号里,独立公式写在一对 $$ 里(⌥⌘B 直接起一个)。

行内公式:质能方程 $E = mc^2$ 就这么写。 独立成行的公式: $$ \int_0^1 x^2 \,dx = \frac{1}{3} $$

有一个脾气值得先知道:光标还在这一对美元号中间时,公式保持源码, 移出去它才渲染。这样改公式不用跟渲染抢——不然每打一个字符它就重排一次,谁也改不下去。

公式不显示?

九成是美元号没配对,或者中间被空格断开了($ x^2 $ 里紧贴美元号的空格会让它不成立)。 按 ⌘/ 看一眼源码最快。

Mermaid 图表

流程图、时序图、甘特图、思维导图这些「按语法画出来」的图,折镜有两条路,各有各的用处。

写在文档里(围栏)

起一个语言是 mermaid 的代码块,图就画在那儿:

```mermaid flowchart LR 写初稿 --> 放两天 --> 改一遍 --> 发出去 ```

适合只属于这一段话的小图。改字就是改图,跟着文档走。

存成一个文件(.mmd)

工具栏上那颗插入图表按钮(树杈形状)会在文档旁边新建一个 .mmd 文件, 把它嵌进当前位置,并打开一个标签页:左边源码,右边预览,改一个字右边立刻变。

适合会被两篇文档同时引用、或者大到需要一整屏来调的图。侧栏里双击那个 .mmd 也能直接打开它。

手绘画布

工具栏上那颗插入绘图按钮(一团涂鸦)用的是 Excalidraw ——手画方框、箭头、随手写字那种。 点它会在文档旁边建一个 .excalidraw 文件,文档里显示这张画的预览。

  • 画上有一颗「编辑」,点进去是整块画布;画完直接回来,预览跟着更新。
  • 文档里同样可以拖右下角的把手改宽度。
  • 侧栏里右键也能直接「新建绘图」,那样它就是一篇独立的画,不属于任何文档。

这些东西存在哪

没有一样藏在数据库里。以一篇 随笔/十一月.md 为例:

东西落在哪文档里写着
图片随笔/img/![说明](img/照片.jpg)
绘图随笔/drawings/![](drawings/绘图.excalidraw)
图表随笔/diagrams/![](diagrams/图表.mmd)
公式 · 表格 · 代码就在 .md 里纯文本,没有附件

也就是说,一篇文档连同它的图,就是那个文件夹里的几个文件。 整个文件夹拷到 U 盘、丢进网盘、放进 Git,都是完整的。