使用文档

墨匣没有复杂的配置项，绝大部分操作在菜单里都能找到。这一页讲清楚怎么用，以及各类 Markdown 语法在墨匣里长什么样。

快速上手

第一次打开，墨匣会显示一份自带说明。想开始写自己的东西，有三条路：

• 新建 — Ctrl + N，直接开一个新文档，保存时再选位置。
• 打开文件 — Ctrl + O，选一个已有的 .md 文件。
• 打开文件夹 — Ctrl + Shift + O，把整个目录当成工作区，侧边栏会列出里面所有 Markdown 文件。

保存用 Ctrl + S。文档有改动时，标题栏会显示一个圆点，保存后消失。设置里可以打开 30 秒自动保存。

编辑方式

墨匣的核心是块级编辑：整篇文档被切成一个个块（段落、标题、列表、引用、代码块……），平时它们都是渲染好的样子。

• 点一下某一块，它就变回 Markdown 源文，光标落在你点的位置。
• 改完之后，点别处或者按 Esc，它会重新渲染成排版后的样子。
• 想整体看源码，按 Ctrl + / 切到源代码模式，再按一次切回来。
• 光标在段落中间按 Enter，会把这一段拆成两个块，标题和引用也适用。
• 在列表项末尾按 Enter 会延续列表；在空列表项上按 Enter 则跳出列表。

这个模式下你需要记住的 Markdown 符号很少——因为渲染结果就摆在眼前，看着不对就知道写错了。

文件与文件夹

打开文件夹之后，侧边栏会变成文件树。它会自动过滤掉无关内容：node_modules、.git、.idea、.vscode 这些目录都不会出现在列表里，只显示 Markdown 和纯文本文件（.md .markdown .mdx .txt）。

侧边栏有两个标签页：文件 和 大纲。大纲按标题层级实时生成，点一条就跳到对应位置——长文档改结构时特别省事。

侧边栏宽度可以拖拽调整，下次打开会记住。不需要时按 Ctrl + Shift + L 收起来。

Markdown 语法速查

强调与行内元素

标题

行首写 1–6 个 # 加一个空格。也可以用 Ctrl + 1 到 Ctrl + 6 直接套用，Ctrl + 0 变回正文。

# 一级标题
## 二级标题
### 三级标题

列表

无序列表用 -、* 或 +，有序列表用 1.。按 Tab 缩进一级，按 Shift + Tab 退回来。

- 第一项
  - 嵌套一项
1. 有序第一项
2. 有序第二项

任务列表

写成 - [ ] 或 - [x]。墨匣里它是个真的复选框，点一下就能勾，不用改源码。

- [x] 已经做完的事
- [ ] 还没做的事

引用与分割线

> 这是一段引用
> 可以写多行

---

表格

按 Ctrl + T 会插入一个 3×3 的空表格，之后直接填内容。想调整对齐，在分隔行里用冒号：

| 左对齐 | 居中 | 右对齐 |
| :--- | :---: | ---: |
| 内容 | 内容 | 内容 |

表格块在非编辑状态下是渲染好的表格；点进去之后会回到竖线分隔的源码形态，改列宽、加行都方便。

数学公式

行内公式用单个美元符号包起来，独立成块的公式用两个：

行内：当 $a \ne 0$ 时，方程有两个解。

块级：
$$
x = \frac{-b \pm \sqrt{b^2-4ac}}{2a}
$$

渲染走 KaTeX，常用的符号、矩阵、分段函数都支持。公式块用 Ctrl + Shift + M 插入。

代码块

输入三个反引号加语言名，再回车，就变成一个代码块。块内按 Tab 缩进、Enter 换行，都不会打断高亮。

```javascript
const debounce = (fn, wait = 300) => {
  let t = null;
  return (...args) => {
    clearTimeout(t);
    t = setTimeout(() => fn(...args), wait);
  };
};
```

内置 190 多种语言的语法定义，配色跟着主题自动切换。

快捷键大全

主题与显示

菜单「主题」里可以切换七套配色：GitHub、Newsprint、Pixyll、Whitey 四套亮色，Night、GitHub Dark、Nord 三套暗色。默认跟随系统的深浅色设置。

字号、行高、字体可以在「文件 → 偏好设置」里调整。缩放用 Ctrl + Shift + = 和 Ctrl + Shift + -，Ctrl + Shift + 0 复位。

专注模式与打字机模式

专注模式（F8）只保留当前正在编辑的段落，其余内容淡出。打字机模式（F9）让当前行始终停留在屏幕中段，视线不用跟着光标上下移动。两个可以叠加使用。

导出

菜单「文件 → 导出」里有两个选项：

• 导出为 HTML — 生成一个自带样式的单文件网页，图片以相对路径引用，方便直接发给别人或传到静态托管。
• 导出为 PDF — 走系统打印引擎，A4 纵向，保留背景色和高亮样式，适合当交付文档。

数据存放位置

墨匣不在文档目录里留任何隐藏文件。你的设置和最近打开记录存在这里：

%APPDATA%\墨匣\settings.json
%APPDATA%\墨匣\recent.json

菜单「帮助 → 打开墨匣配置目录」可以直接跳过去。把这两个文件删掉，程序就回到全新状态，文档本身不受影响。

macOS 上的几点不同

• 选对包 — M 系列（Apple 芯片）和 Intel 芯片是两个包。左上角 → 「关于本机」看「芯片」一行就知道该下哪个。
• 首次打开 — 程序没有 Apple 开发者签名，系统会拦一次。右键点「墨匣」→ 选「打开」→ 再点一次「打开」。之后就能正常双击了。
  想省掉这一步，也可以先在终端里执行：xattr -dr com.apple.quarantine /Applications/墨匣.app
• 快捷键 — 界面上写的 Ctrl 在 Mac 上就是 ⌘（Command）。⌘+Q 退出，⌘+W 关窗口。
• 配置目录 — 在 ~/Library/Application Support/墨匣/，菜单「帮助 → 打开墨匣配置目录」可直达。
• 关掉窗口不等于退出 — 这是 Mac 的常规行为。要彻底退出用 ⌘+Q，或点 Dock 图标右键选退出。