笔记 (Jawsidian)

Jawsidian 是一个内置的 Markdown 笔记工作区,具备所见即所得编辑、图谱视图、Wiki 链接、图片粘贴、文件树导航和基于 ripgrep 的搜索功能。

访问笔记

笔记位于 Dashboard 的 Notes 标签页中,以 Markdown 文件的形式存储在 Dashboard 的笔记目录中。

所见即所得编辑器

主要的编辑体验基于 Milkdown 的所见即所得编辑器,在保留底层 Markdown 格式的同时提供富文本编辑。功能包括:

Wiki 链接

使用 [[target|label]] 语法在笔记之间创建链接。所见即所得编辑器将 Wiki 链接渲染为可交互的组件:

图谱视图

图谱视图基于 Wiki 链接可视化笔记之间的连接关系。笔记显示为节点,链接显示为边。图谱控件可用于调整布局、缩放和筛选。

图片粘贴

可以直接从剪贴板将图片粘贴到笔记中。图片通过 POST /api/dashboard/notes/asset 上传为资源文件,并嵌入到 Markdown 中。

文件树

侧边栏显示所有笔记的层级文件树。你可以在文件树中创建、重命名和删除笔记。文件树 API 由 GET /api/dashboard/notes/tree 提供支持。

搜索

笔记搜索在后端使用 ripgrep(src/manager/notes/search.ts)。搜索侧边栏支持:

笔记 API

方法路径描述
GET/api/dashboard/notes/info笔记 vault 信息
GET/api/dashboard/notes/tree文件树
GET/api/dashboard/notes/indexVault 索引(Wiki 链接、外链)
GET/api/dashboard/notes/searchRipgrep 搜索
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