文档编辑器
Markdown 基础
标题、列表、粗体、链接、代码 — 三分钟掌握 Markdown 核心。
为什么用 Markdown
Kition 的编辑器基于 CodeMirror 6，配合 Obsidian 风格的内联装饰 — 你写的永远是纯文本 .md，但渲染层会即时把语法折叠成漂亮的样式。这意味着即使十年后没有 Kition，你的笔记打开依然是干净的 Markdown。
Markdown 的核心思路：约定俗成的字符就是格式。开头一个 # 就是一级标题，前面一个 - 就是列表项。无需打开工具栏、无需鼠标，思路不被打断。
常用语法
# / ## / ###— 一到三级标题（最多支持到六级）- / *— 无序列表；嵌套用两个空格或一个 Tab1.— 有序列表；编号会自动重排bold/*italic*/~~strike~~/ `[text](url)链接 /图片>引用块，可以多层嵌套---分割线，单独一行- 代码块用三个反引号开头，可指定语言：```
ts```
一个完整示例
# 周一站会
## 进展
- 完成登录页 A/B 测试结果分析
- 修复 `auth/refresh-token` 的并发竞态
## 风险
> 数据迁移脚本在 staging 跑了 47 分钟，生产可能要安排维护窗口。
## 下一步
1. 写 RFC 草稿
2. 同步给 @platform 团队
3. 周三前定稿
---
参考链接：[迁移设计](https://example.com/rfc)Kition 扩展
Kition 在标准 CommonMark / GFM 之上加了几个常用扩展。所有扩展都是「优雅降级」的 — 在其他 Markdown 工具里打开，最多只是渲染成普通文本，不会损坏数据。
[[wikilink]]— 双链到另一个文档，支持别名和段落锚点> [!TIP]— Callout 块，五种类型可选$$math$$— KaTeX 行内 / 块级公式- ```
mermaid``` — 流程图、时序图、ER 图 ![[Tables/projects]]— 嵌入数据表或视图- [ ]/- [x]— 任务清单，可全局聚合
快捷键与编辑器行为
Cmd/Ctrl + B加粗，Cmd/Ctrl + I斜体- 选中文字后粘贴 URL 自动转成
[文字](url) - 在列表行按 Enter 自动续写下一项；连按两次 Enter 退出列表
Tab缩进当前列表项，Shift + Tab反缩进Cmd/Ctrl + /切换当前行注释（在代码块内有效）
常见坑
- 标题
#后面必须有一个空格 —#标题不会被识别 - 行尾两个空格 + 换行才是
<br>；普通换行只是同一段落 - 反引号里的反引号要用双反引号包裹：`
- 中文标点（
，。）紧贴*会让加粗失效，留个空格更稳