에디터

웹 앱의 노트 화면 상단에는 읽기 보기 / 편집 전환 하나가 있습니다. 풍부한 렌더링은 읽기 보기에서 이루어지고, 편집은 마크다운을 쓰기 위한 일반 CodeMirror 6 텍스트 입력입니다.

읽기 보기 (렌더링)

뷰어는 Obsidian 호환을 위해 설계된 remark/rehype 스택입니다. Obsidian에서 렌더링되면 여기서도 렌더링되어야 합니다.

CommonMark + GFM: 제목, 목록, 표, 코드 블록, 취소선, 작업 목록
위키링크: [[Note Title]]과 [[Note Title|Display Text]]가 /notes/<path>로 연결되는 링크로 렌더링됩니다
이미지 임베드: ![[image.png]]는 인증된 첨부 파일 API로 연결됩니다
콜아웃: Obsidian 스타일의 > [!note], > [!warning], > [!tip] 등을 @portaljs/remark-callouts로 처리합니다
KaTeX 수식: $inline$ 과 $$display$$
Mermaid 다이어그램: ```mermaid 코드 블록
구문 강조: rehype-highlight로 렌더링한 코드 블록
Frontmatter: 파일 맨 위의 YAML은 gray-matter로 해석하고, 본문은 그 아래에 렌더링됩니다
제목 자동 링크: 모든 제목에 슬러그와 앵커 링크가 붙습니다

편집 모드 (쓰기)

편집 모드에서는 마크다운 언어 플러그인(구문 강조), 줄 바꿈, iOS Safari의 자동 확대를 막는 모바일 친화적인 16px 글꼴을 갖춘 CodeMirror 6 입력으로 바뀝니다.

저장 버튼은 없습니다. 에디터는 입력하는 대로 자동 저장합니다. 노트 상단의 상태 표시기가 쓰기 진행 중에는 Saving…, 완료되면 Saved, 쓰기에 실패하면 클릭 가능한 Retry 링크와 함께 _Save failed_를 표시합니다.

웹 에디터는 의도적으로 빠른 기록용 화면입니다. 노트를 열고, 편집하고, 떠나면 됩니다. 더 풍부한 작성(슬래시 메뉴, 에디터 안의 찾기/바꾸기, 위키링크와 태그 자동 완성)에는 Obsidian이 맞는 도구입니다. 이 구분은 빈틈이 아니라 설계입니다. Obsidian은 이미 뛰어난 에디터이고 우리는 거기에 네이티브로 동기화하므로, 웹 앱은 Obsidian에서 잘하기 어려운 일(보관함 간 탐색, Obsidian iOS 앱 없는 모바일 접근, 어디서든 브라우저 접근)에 집중합니다.

충돌에 안전한 편집

웹 에디터는 플러그인과 같은 동기화 엔진을 거칩니다. 노트를 열어 둔 동안 다른 기기가 같은 노트를 편집해도, 에디터는 당신의 작업을 잃지 않고 반응합니다.

들어오는 원격 편집은 3-way 병합으로 열린 초안에 합쳐집니다. 깔끔하게 병합되면 조용히 처리됩니다.
저장이 다른 기기의 쓰기와 경합하면 백엔드가 409를 반환합니다. 에디터는 최신 버전을 가져와 3-way 병합으로 당신의 편집을 그 위에 다시 얹고 저장을 자동으로 재시도합니다.
병합에서 줄 단위로 실제 겹침이 있으면 초안은 그대로 유지되고, 차단하지 않는 ConflictBar가 나타나 세 가지 선택지를 줍니다. Keep mine, Take theirs, View merge. 조용히 버려지는 것은 없습니다.

Obsidian 플러그인은 지원하지 않습니다

Obsidian 커뮤니티 플러그인에 의존하는 모든 것(Dataview 쿼리, Templater 출력, 사용자 지정 캔버스 확장, Excalidraw 도형 등)은 웹 에디터에서 실행되지 않습니다. 웹 앱은 자체 렌더러를 쓰며, Obsidian 설치본의 플러그인 코드를 실행할 수 없습니다. Dataview 블록은 일반 코드 블록으로 렌더링되고, Templater 구문은 풀리지 않은 채 남는 식입니다.

플러그인 렌더링에 의존하는 노트도 안전합니다. 일반 마크다운으로 동기화되며 Obsidian에서는 올바르게 보입니다. 다만 웹 앱에서 볼 때 동적 렌더링이 적용되지 않을 뿐입니다.

플러그인 호환은 앞으로의 메이저 버전에서 검토할 수도 있지만 현재 로드맵에는 없습니다.

모바일

에디터는 터치 친화적이지만 작은 화면에는 한계가 있습니다. 휴대폰에서 본격적으로 편집하려면 보통 Obsidian 모바일이 더 낫습니다. 간단한 편집과 검색은 웹 앱에서도 잘 작동합니다.