小贴士

0. 约定

MD 在未作特别说明的情况下，指 Markdown 文件。
快捷键 Mod 指在 MacOS 下为 Command 键，其它平台下为 Ctrl 键。

1. MD 快捷编辑

DaoBox 采用的设计是，默认预览优先，所以 MD 文件打开都是渲染后结果，在浏览时，如需快速做出修改，可采用弹出小窗式修改，直接双击需要修改的位置，会自动弹出编辑器并定位到相关位置。修改完成后，可以直接 Mod+Enter 保存修改并关闭，也可以，Mod+S 仅保存。连续按2次 ESC 退出小窗修改。源码里一次改多处见小贴士。

2. 私有区域

用扩展属性里的 #tag 给块打标签。其中 #private 是系统级默认私有区：站点预览 / 导出渲染时会剔除，读者看不到。

{#private}
这段只留在源文件里，对外渲染不可见。

{#private}
## 整节私有

标在标题上时，会覆盖到下一个同级或更高级标题之前。

其它 tag（如 {#draft}）可按需添加；在主题 / 模板里通过排除列表（exclude_tags）控制显示或隐藏，不必改正文。库内写作预览可通过标题栏单独开关，控制是否显示这些被排除的区域，与对外渲染互不影响。

3. 对通用 MD 做了哪些扩展

在标准 Markdown / GitHub Flavored Markdown 之上，DaoBox 主要多了这些：

扩展属性 `{…}`

用花括号给标题、段落、链接、图片等加属性；多项用空格或逗号隔开：

写法	含义	例
`#name`	Tag（不是 HTML id）	`{#private}` `{#draft}`
`.name`	CSS class	`{.notice}`
`key`	无值开关	`{tc underline}`
`key=value`	键值；值含空格或逗号时加双引号	`{color=red wh=1.5em}`

常见附着位置：

{color=red tc}
# 红色居中标题

带样式的[链接](https://everkm.cn){color=orangered new-tab}

![图](./a.png){corner=1em}

我是{color=red}#这段#文字。

常用快捷键名：tl / tc / tr（对齐）、ul / underline、color / bgcolor、pa / px / py、corner、wh / w / h、new-tab（新标签打开链接）。需要稳定页内锚点时写 {id=section-name}。

编辑时在 { 内可按前缀补全：# → 库内 tag，. → class，裸词 → 属性名，key= → 该 key 已有过的值。

私有区与 tag 排除见小贴士。

4. 内部链接如何支持哪些形式

推荐用 [[目标]]，由系统解析成最终 URL，避免手写相对路径在导出时失效。

[[quick-start]]                 # slug 或标题（忽略大小写）
[[./faq/]]                      # 相对当前文件目录
[[/docs/guide/quick-start.md]]  # 从库根的逻辑路径
[[./page#section-id]]           # 带锚点（目标侧请用稳定 {id=...}）
[[./faq/|常见问题]]              # | 后为显示文案

匹配顺序大致是：slug → 标题 → 路径。无前缀时先按路径后缀全库找；多篇命中会报歧义，改用 [[./…]] 或 [[/…]] 即可。末尾带 / 按目录默认页解析。也可链到 PDF、图片等非 MD 资源。

与标准链接的分工：外链用 [文字](https://…)；库内互引用内链。

5. 多光标与批量改字

源码编辑（分栏或小窗）里可以一次改多处。改完后键入、退格、以及加粗 / 斜体 / 列表等写作命令，会作用在所有光标和选区上。

Alt 在 Mac 上是 Option。内链跟随仍是 Mod+点击，和加点光标分开。

操作	作用
`Alt+点击`	在点击处追加一个光标
`Alt+拖`	矩形 / 列选。贴着行尾往下拖，会在每一行行尾放一个光标（行短的落在该行真正的结尾）
选中一段再 `Mod+D`	选中下一处相同文本，并累加选区；可连按
`Mod+Shift+L`	一次选中当前选区（或词）的全部出现
`Mod+U`	撤销上一次选区变化（去掉刚加的那个光标 / 选区），不是撤销正文；可连按逐步退回
`Esc`	一次收掉全部多光标，回到单个光标

Esc 由近到远：补全开着先关补全；查找开着先关查找；有多光标则收成一个；小窗编辑里再连续按两次才关闭（见小贴士）。

Mod+U 与 Mod+Z 分工：前者只回退光标/选区栈，后者撤销正文编辑。

多选时状态栏右侧会显示 「N 选区」；点一下可收成单个光标（与 Esc 收光同效）。单选时不显示。

打开一篇 Markdown 后，可从菜单把当前预览导出为 PDF（含打印预览；可调分栏、横向、正文基础字号）或 Word。不必先导出整站。

若只想把一篇笔记放到网上给人看，可用 单篇分享到 Youlog：发布到 youlog.net，并可设置有效期。整库成站仍走站点预览与发布流程。

7. 库外文件与快速打开

不必先开完整工作区：可把 Markdown 或文件夹 拖进窗口，或在系统里对 .md 使用右键 「使用 DaoBox 打开」。松散文件会以 Guest 等方式打开。

命令面板的快速打开也支持粘贴 绝对路径 直达某篇笔记。