笔记 (Jawsidian)
Jawsidian 是一个内置的 Markdown 笔记工作区,具备所见即所得编辑、图谱视图、Wiki 链接、图片粘贴、文件树导航和基于 ripgrep 的搜索功能。
访问笔记
笔记位于 Dashboard 的 Notes 标签页中,以 Markdown 文件的形式存储在 Dashboard 的笔记目录中。
所见即所得编辑器
主要的编辑体验基于 Milkdown 的所见即所得编辑器,在保留底层 Markdown 格式的同时提供富文本编辑。功能包括:
- 富文本编辑 -- 标题、粗体、斜体、列表、代码块、表格
- 斜杠菜单 -- 输入
/快速执行格式化命令 - 表格右键菜单 -- 右键点击表格进行行/列操作
- Frontmatter 面板 -- 在结构化界面中编辑 YAML frontmatter(别名、标签、创建时间)
- Vim 模式 -- 可选的 Vim 键绑定,支持键盘驱动编辑
Wiki 链接
使用 [[target|label]] 语法在笔记之间创建链接。所见即所得编辑器将 Wiki 链接渲染为可交互的组件:
- 已解析的链接具有样式且可点击,点击后导航到目标笔记
- 未解析的链接以不同样式显示,表示目标笔记尚不存在
- 新链接使用 vault 索引作为客户端回退,直到后端刷新外链索引
图谱视图
图谱视图基于 Wiki 链接可视化笔记之间的连接关系。笔记显示为节点,链接显示为边。图谱控件可用于调整布局、缩放和筛选。
图片粘贴
可以直接从剪贴板将图片粘贴到笔记中。图片通过 POST /api/dashboard/notes/asset 上传为资源文件,并嵌入到 Markdown 中。
文件树
侧边栏显示所有笔记的层级文件树。你可以在文件树中创建、重命名和删除笔记。文件树 API 由 GET /api/dashboard/notes/tree 提供支持。
搜索
笔记搜索在后端使用 ripgrep(src/manager/notes/search.ts)。搜索侧边栏支持:
- 防抖查询输入
- 过期请求中止(通过 AbortController)
- 点击打开搜索结果
- 类型化错误渲染
笔记 API
| 方法 | 路径 | 描述 |
|---|---|---|
| GET | /api/dashboard/notes/info | 笔记 vault 信息 |
| GET | /api/dashboard/notes/tree | 文件树 |
| GET | /api/dashboard/notes/index | Vault 索引(Wiki 链接、外链) |
| GET | /api/dashboard/notes/search | Ripgrep 搜索 |
| GET/POST/PUT | /api/dashboard/notes/file | 读取、创建、更新笔记文件 |
| POST | /api/dashboard/notes/asset | 上传图片资源 |
CLI 访问
# Write a note
jaw connector notes write "My Note" "# Content here"
# List notes
jaw connector notes list