Markdown 에디터

Docs

Markdown 에디터

Glif 에디터는 Markdown 파일을 원본으로 유지하면서 같은 문서를 소스와 여러 작업 보기에서 다룬다. 보기를 바꿔도 별도 문서 복사본을 만들지 않으며, 다시 소스로 돌아오면 같은 문서와 편집 세션을 이어간다.

작성 화면

상단 보기 선택기에서 현재 문서가 지원하는 소스, Page, Table, Kanban, Timeline, Chart 같은 작업 보기를 연다.
좁은 창에서는 액션이 더보기 메뉴로 이동한다. 보기 선택과 저장 상태는 사라지지 않는다.
에디터 더보기 메뉴의 내보내기...는 클릭한 시점의 현재 문서를 고정해 기존 출력 선택 화면을 연다. 기본값은 현재 문서 PDF이며 지원되는 다른 문서 형식으로 바꿀 수 있다. 다른 문서로 전환해도 열린 출력 화면의 대상은 바뀌지 않고, 출력 화면을 닫거나 일반 출력 진입점으로 다시 열면 고정이 해제된다.
새 작업공간에서는 삽입 도구 모음을 기본적으로 숨겨 본문을 조용하게 유지한다. / 명령, 명령 팔레트, 단축키, 컨텍스트 메뉴와 더보기는 그대로 사용할 수 있으며, Writing 설정에서 도구 모음을 다시 켤 수 있다. 통계, 문단 강조, 타자기 모드, 서식 기호와 헤딩 경로도 작업공간별로 조정하고, 맞춤법 검사는 전역 설정으로 관리한다.
에디터 inspector는 현재 보기와 문서에 맞는 정보만 지연해서 연다. 숨긴 정보 영역은 보기 전환만으로 자동으로 나타나지 않는다.

원문 렌즈

에디터 헤더 메뉴의 Source Lens 또는 Ctrl/Cmd+Shift+/를 사용하면 이미지, 표, 수식, Mermaid·D2 다이어그램, embed 같은 인라인 렌더링을 한꺼번에 끄고 Markdown 원문을 확인할 수 있다. 다시 끄면 같은 위치에서 렌더링 보기로 돌아온다.

원문 렌즈를 전환해도 선택, 접기, 실행 취소 기록과 현재 스크롤 위치는 유지된다. 문법 강조, 줄 번호, 자동 완성, 링크 명령과 맞춤법 검사는 계속 사용할 수 있다. Source Lens는 작업 공간별로 기억되며, 마커만 표시하는 Formatting Marks 설정과는 독립적이다. 기존 Markdown HTML 주석 단축키 Ctrl/Cmd+/도 그대로 동작한다.

블록과 구조 편집

Markdown 표, callout, 이미지, 코드, 수식, D2 다이어그램, embed는 원본 범위를 유지한 채 렌더링과 편집 도구를 제공한다. 렌더링에 실패해도 원문 표시와 다시 시도 경로를 유지한다. 헤딩·목록·할 일·표 같은 구조 명령은 현재 선택 범위에 적용되며 일반 실행 취소 기록에 들어간다.

D2·Mermaid fenced block이나 독립된 $$...$$ 블록 수식을 편집할 때는 원문 바로 아래에 미리보기가 함께 유지된다. 블록 밖으로 이동하면 기존 렌더링 보기로 돌아가며, 블록 위쪽 편집으로 위치만 바뀌면 기존 미리보기를 재사용한다.

링크와 각주

[[를 입력하고 문서 제목, 별칭, 또는 경로 일부를 이어 쓰면 현재 프로젝트의 문서 후보가 나타난다. 같은 제목이 여러 개면 상대 경로로 구분하며, 선택은 한 번의 실행 취소로 되돌릴 수 있다.
Markdown 링크를 일반 클릭하면 커서와 원문 편집을 우선한다. 링크를 열려면 Ctrl/Cmd를 누른 채 클릭하거나 링크 위에서 Ctrl/Cmd+Enter를 사용한다.
각주는 GFM 형식인 [^note] 참조와 [^note]: 설명 정의를 사용한다. 참조 위에서 Ctrl/Cmd+Enter를 누르면 같은 문서의 정의로 이동한다.

문서 요약과 섹션 목차 링크

단독 줄의 일반 Markdown 링크는 원문을 유지한 채 다른 읽기 표현으로 바꿀 수 있다. [요약](#)는 링크 메뉴에서 Summary card를 선택하면 현재 문서의 title, summary/description, 태그를 요약 카드로 보여 준다. #제목 같은 anchor 링크는 요약 카드가 아니라 일반 링크로 남는다.

실제 파일로 존재하는 ./_index.md 링크는 같은 메뉴에서 Section TOC를 선택해 해당 섹션의 문서를 목차로 표시할 수 있다. 목차는 문서의 weight와 경로 순서를 따르며 기본 깊이 2, 최대 100개로 제한된다. 대상 index가 없거나 읽을 수 없으면 원래 링크를 그대로 유지하고 이유를 표시한다. 이 두 표현은 Markdown 본문을 복사하지 않으며, 발행 결과에서도 읽을 수 있는 요약/목차로 바뀐다.

상호운용 Markdown 문법

기능	원문	동작과 제약
강조 표시	`==중요==`	편집 중 원문을 보존하고, 발행할 때 의미 있는 `<mark>`로 변환한다. 중첩된 강조 표시는 원문으로 남는다.
Mermaid	`~~~mermaid` fenced block	에디터에서 필요할 때만 렌더러를 불러오며, 실패해도 원문 편집 버튼을 유지한다. D2로 자동 변환하지 않는다.
이미지 폭	`![설명	640](image.png)`
안전한 인라인 HTML	`<br>`, `<br/>`, `<br />`, `<kbd>Ctrl+K</kbd>`	줄바꿈과 키보드 입력만 의미 있게 표시하며 원문은 바꾸지 않는다. 속성, 중첩 HTML, `<details>`, styled `<span>`, malformed tag는 부분 렌더하지 않고 원문으로 남긴다.

코드 블록과 인라인 코드 안의 위 문법은 변환하지 않는다. 파일은 계속 일반 Markdown 원문이므로 다른 도구에서 지원하지 않는 확장 문법도 직접 확인하고 수정할 수 있다.

문서 보기와 지식 정보

Page, Timeline, Kanban, Hierarchy, Table, Chart, Gallery, Calc, Gantt, Mindmap, Slide 등의 보기는 현재 에디터 문서 경로를 기준으로 열린다. 메타데이터를 저장하면 Properties, 링크/참조, 지식 인덱스가 문서를 닫았다 다시 열지 않아도 갱신된다.

Cart로 작성 재료 모으기

Shelf, 문서 검색, Outline과 Assembly Canvas에서 문서·헤딩·파일·URL을 Cart에 담아 현재 Binder의 작성 재료로 모을 수 있다. Cart가 접혀 있어도 항목 수가 표시되며, 받을 수 있는 항목을 끌어오면 잠시 펼쳐져 drop 대상과 허용되는 종류를 안내한다. drag가 끝나면 사용자가 정한 접힘 상태로 돌아간다.

같은 항목을 다시 담으면 순서나 내용을 바꾸지 않고 이미 Cart에 있다는 안내를 표시한다. 지원하지 않는 항목과 추가 실패도 성공과 구분해 알린다. 명령 팔레트에서 Cart 열기를 실행하거나 기본 단축키 Ctrl+Alt+C를 사용하면 현재 문서와 스크롤 위치를 바꾸지 않고 Cart를 펼쳐 포커스한다. 단축키는 설정에서 변경할 수 있다.

Cart의 문서와 헤딩은 컨텍스트 메뉴의 옆으로 열기로 현재 작성 문서를 유지한 채 콘텐츠 영역 오른쪽 companion editor에서 확인할 수 있다. 헤딩에 기존 anchor가 있으면 해당 위치로 이동하며, 옆 패널을 만들 수 없을 때는 일반 열기로 전환됐음을 안내한다. 파일과 URL에는 이 동작을 제공하지 않는다.

Cart item에는 메모, 짧은 인용, 사용 의도, 조립 대상과 사용 여부를 기록할 수 있다. 로컬 문서·헤딩·asset은 원본 fingerprint를 비교해 현재, 변경됨, 없음 상태를 표시하고, URL과 임시 메모처럼 로컬 비교 대상이 아닌 항목은 확인 안 됨으로 구분한다. active editor의 선택 구절이나 임시 메모도 Cart에 바로 추가할 수 있다.

실수로 Cart를 비웠다면 같은 Binder에서 한 번 되돌릴 수 있다. 현재 순서를 이름 있는 collection으로 저장했다가 기존 항목을 지우지 않고 다시 합칠 수도 있다. 반복할 조립 순서는 Recipe로 저장한다. Recipe 실행 결과는 출처 link와 stale/missing 경고를 포함하는 일반 Markdown 문서이며, 원본 본문을 Cart 저장소로 복제하거나 생성 문서와 자동 동기화하지 않는다.

가져오기·내보내기 보존 범위

형식	지원 계약	복구·제약
Markdown 폴더	경로와 파일 바이트를 그대로 왕복한다. 사용자가 편집한 파일만 달라진다.	상위 경로 탈출이나 대소문자 중복 경로는 쓰기 전에 중단한다.
HTML / Web Clip	제목, 링크, 이미지, 표, 코드 등을 정규화해 Markdown으로 만든다.	제거되는 지원 불가 요소 수를 쓰기 전에 알리고 원본 `source.html`을 먼저 보존한다.
EPUB	챕터 순서, 내비게이션, 리소스를 포함해 내보낸다.	내보내기 전용이다. 필수 리소스가 없으면 변환 전에 중단하며 EPUB 재가져오기를 약속하지 않는다.
PDF	원문 문서 경로와 페이지·템플릿 생성 옵션을 가진 스냅샷을 만든다.	스냅샷/내보내기 전용이며 PDF를 편집 가능한 Markdown으로 왕복한다고 간주하지 않는다.

저장과 복구

저장 완료는 원본 파일을 다시 읽어 같은 내용인지 확인한 뒤에만 표시된다. 외부 변경, 지원하지 않는 인코딩, 혼합 줄바꿈, 닫기 제한 시간, 비정상 종료 복구 절차는 문서 저장·닫기·복구에서 확인한다.

제목 저장이 실패하면 입력한 제목을 지우지 않고 원인을 표시하며 제목 입력으로 돌아가 다시 시도할 수 있다.
이미지 붙여넣기와 드롭은 작업을 시작한 위치를 이후 입력에 맞춰 추적한다. 여러 리소스 중 하나가 실패하면 이미 만든 파일을 정리하고, 정리까지 실패하면 오류를 숨기지 않는다.
문서 이름 변경은 적용 전에 최신 링크 검토를 요구한다. 제목·경로·참조 문서 중 하나라도 저장에 실패하면 앞선 변경을 역순으로 되돌린다. 완전히 되돌리지 못한 경우에는 여전히 변경된 경로를 오류에 표시하고 성공으로 처리하지 않는다.

문서 저장·닫기·복구