Markdown 编辑
Knowledge Base 使用 Tiptap 富文本编辑器，提供所见即所得的 Markdown 体验。
设计理念
三方之长兼得：
| 对比 | 纯 Markdown 编辑器 | Notion 类编辑器 | Knowledge Base |
|---|---|---|---|
| 所见即所得 | ❌ | ✅ | ✅ |
| 保留原生 Markdown | ✅ | ❌（专有格式） | ✅ |
| 键盘党友好 | ✅ | 部分 | ✅ |
| 斜杠命令 | ❌ | ✅ | ✅ |
| 代码高亮 | 取决于渲染器 | 部分 | ✅（30+ 语言） |
快速语法
直接打字就会转换：
| 输入 | 结果 |
|---|---|
# + 空格 | 一级标题 |
## + 空格 | 二级标题 |
- + 空格 | 无序列表 |
1. + 空格 | 有序列表 |
-[] + 空格 | 待办清单 |
> + 空格 | 引用块 |
``` | 代码块 |
--- + 回车 | 分隔线 |
**加粗** | 加粗 |
*斜体* | 斜体 |
`行内代码` | 行内代码 |
[[笔记名]] | 双向链接 |
斜杠命令
在任意位置按 / 呼出命令菜单：
- 标题：H1、H2、H3
- 列表：无序列表、有序列表、待办清单
- 内容块：代码块、引用、分隔线
- 媒体：图片（支持拖拽 / 粘贴）、链接
- 表格：可调整列宽、合并单元格
- 双向链接：
[[笔记名]]
代码块
支持 30+ 语言语法高亮：
- JavaScript / TypeScript
- Python、Go、Rust、Java、C/C++、C#
- HTML / CSS / SCSS
- Shell、SQL、JSON、YAML、Markdown
- ……
代码块顶部显示语言标签，右侧有一键复制按钮。
表格
- 可视化拖拽列宽
- 行内斜杠命令插入行/列
- 单元格支持 Markdown 语法（粗体、链接等）
图片
- 拖拽：直接从桌面 / 浏览器拖图片到编辑器
- 粘贴：
Ctrl+V/Cmd+V粘贴剪贴板图片 - 上传：斜杠命令
/image选择本地文件
所有图片保存在本地 attachments/ 目录，Markdown 引用为相对路径。
数学公式（规划中）
未来版本将支持 LaTeX 公式（$E=mc^2$）。
保存机制
- 自动保存：编辑后 1 秒防抖自动保存（顶栏提示"未保存"→"已保存"）
- 手动保存：
Ctrl+S/Cmd+S强制保存 - 失败重试：如遇数据库锁冲突，自动重试 3 次
导出
右上角 "导出" 按钮可把当前笔记导出为标准 Markdown (.md)，完全兼容 Obsidian、Typora、VS Code 等工具。
详见 导入导出。