노트 (Jawsidian)
Jawsidian은 위지위그(WYSIWYG) 편집, 그래프 뷰, 위키링크, 이미지 붙여넣기, 파일 트리 탐색, ripgrep 기반 검색을 지원하는 내장 마크다운 노트 작업 공간입니다.
노트 접근
노트는 대시보드의 Notes 탭에서 사용할 수 있습니다. 노트는 대시보드의 노트 디렉터리에 마크다운 파일로 저장됩니다.
위지위그(WYSIWYG) 편집기
주요 편집 환경은 기본 마크다운 형식을 유지하는 Milkdown 기반 위지위그 편집기입니다. 주요 기능은 다음과 같습니다:
- 서식 있는 텍스트 편집 -- 제목, 굵게, 기울임, 목록, 코드 블록, 표
- 슬래시 메뉴 --
/를 입력하여 빠른 서식 명령 사용 - 표 컨텍스트 메뉴 -- 표를 우클릭하여 행/열 작업 수행
- 프론트매터 패널 -- 구조화된 UI에서 YAML 프론트매터(별칭, 태그, 생성일) 편집
- Vim 모드 -- 키보드 중심 편집을 위한 선택적 vim 키바인딩
위키링크
[[target|label]] 구문을 사용하여 노트 간에 링크할 수 있습니다. 위지위그 편집기는 위키링크를 라이브 위젯으로 렌더링합니다:
- 연결된 링크는 스타일이 적용되어 클릭 가능하며, 대상 노트로 이동합니다
- 미연결 링크는 대상이 아직 존재하지 않음을 나타내는 다른 스타일로 표시됩니다
- 새 링크는 백엔드가 발신 링크 인덱스를 갱신하기 전에 볼트 인덱스를 클라이언트 측 폴백으로 사용합니다
그래프 뷰
그래프 뷰는 위키링크를 기반으로 노트 간의 연결을 시각화합니다. 노트는 노드로, 링크는 엣지로 표시됩니다. 그래프 컨트롤을 통해 레이아웃, 줌, 필터링을 조정할 수 있습니다.
이미지 붙여넣기
클립보드에서 직접 노트에 이미지를 붙여넣을 수 있습니다. 이미지는 POST /api/dashboard/notes/asset를 통해 에셋으로 업로드되고 마크다운에 삽입됩니다.
파일 트리
사이드바에 모든 노트의 계층적 파일 트리가 표시됩니다. 트리에서 노트를 생성, 이름 변경, 삭제할 수 있습니다. 파일 트리 API는 GET /api/dashboard/notes/tree로 지원됩니다.
검색
노트 검색은 백엔드에서 ripgrep을 사용합니다(src/manager/notes/search.ts). 검색 사이드바는 다음을 지원합니다:
- 디바운스된 쿼리 입력
- 오래된 요청 중단 (AbortController 사용)
- 클릭하여 결과 열기
- 타입별 오류 렌더링
노트 API
| 메서드 | 경로 | 설명 |
|---|---|---|
| GET | /api/dashboard/notes/info | 노트 볼트 정보 |
| GET | /api/dashboard/notes/tree | 파일 트리 |
| GET | /api/dashboard/notes/index | 볼트 인덱스 (위키링크, 발신 링크) |
| 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