노트 (Weasley Podex Notes)
Weasley Podex Notes은 위지위그(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
weasley-podex connector notes write "My Note" "# Content here"
# List notes
weasley-podex connector notes list