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 等工具。

详见 导入导出。

思维导图视图

笔记编辑器顶栏的 🧠 按钮可把当前 markdown 标题层级实时渲染为思维导图（基于 markmap），与编辑器并排分栏显示：

• 真分屏：编辑器和思维导图各占一半，互不遮挡；中间分隔条可拖拽调宽（320–1200px），宽度自动记忆
• 实时跟随：边写边看——每次敲键，右侧导图自动刷新
• 只读视图：节点不能拖拽，但工具栏支持放大/缩小/自适应/导出 SVG
• 打开时大纲自动隐藏：避免三栏挤压；关闭时自动恢复
• 导出 SVG：可矢量保存供 Figma/Inkscape/markmap.dev 二次编辑

适用场景：长文写作时鸟瞰结构、复盘文章脉络、快速从笔记生成幻灯片大纲。

在新窗口打开（多屏对照）

顶栏 ↗ 按钮把当前笔记弹到独立 OS 窗口（精简模式，无侧栏 / Tabs），用于：

• 两笔记对照：开两个窗口，各显示一篇笔记，Win + 方向键 Snap 拼屏
• 跨显示器：把一个笔记拖到副屏，主屏写另一篇
• 保留主窗口环境：副窗口独立，不打扰主窗口的 Tabs / 侧栏布局

同一笔记重复点击只会前置已存在的窗口，不会开多个。