Markdown 작성과 에디터
Glif의 에디터는 Markdown 파일을 작성·인덱스·출판의 기준 원본으로 유지한다. 이 장은 텍스트 입력만이 아니라 heading 구조를 보고 옮기고, 일부 내용을 새 note로 추출하고, 링크와 임베드를 바꾸고, 이름 변경이 참조에 미치는 영향까지 다룬다.
가장 먼저 익힐 네 가지
- 저장 상태가 완료되기 전에 문서를 닫거나 외부 편집을 덮어쓰지 않는다.
- Outline은 Markdown heading 구조의 다른 표현이며 별도 목차 데이터베이스가 아니다.
- section 이동·복제·추출 뒤 Source에서 실제 Markdown diff를 확인한다.
- rename과 reference rewrite는 함께 성공하거나 복구 가능한 오류를 보여야 한다.
장 구성
| 주제 | 대표 작업 | 저장 결과 |
|---|---|---|
| 작성 화면과 저장 | 본문·front matter 수정 | 현재 .md 파일 변경 |
| Outline과 section | reveal, focus, 접기, 위·아래 이동, drag reorder | heading section 순서 변경 |
| 추출과 참조 | 문단·section을 새 note로 추출 | 새 파일과 link/embed 생성 |
| 이름 변경 | note rename과 alias/reference rewrite | 경로와 지원 참조 동시 변경 |
| plain text 정리 | 선택·문단·문서 normalize | formatting을 제거한 텍스트 |
| metadata | summary, pitch와 projection 선택 경계 |
front matter와 .glif 설정 분리 |
| 문서 드롭 | link, 참조 보기, embed, text copy intent | 상대 참조 또는 독립 본문 삽입 |
연속 실습
project-brief.md에 새 H2를 추가하고 Outline에서 위치를 확인한다. section을 위로 이동한 뒤 Source diff를 확인하고, 한 문단을 decision-note.md로 추출한다. 원래 문서에는 새 note link가 남아야 한다. 마지막으로 이름을 바꾸고 참조가 깨지지 않았는지 Link Health에서 확인한다.
먼저 Outline으로 긴 문서 구조 편집하기에서 H2~H6 표시 깊이, 원문 이동과 현재 위치 reveal, section 이동·복제·focus·접기·drag reorder를 하나의 fixture로 실습한다. 각 원문 변경과 세션 전용 동작을 단계별 이미지와 세 개의 실제 조작 영상으로 구분한다.
이어서 문단과 섹션을 새 노트로 추출하고 링크를 임베드로 바꾸기에서 재사용할 내용을 독립 Markdown note로 분리하고, 원문 상대 link와 canonical wiki embed를 실제 파일·이미지·영상으로 검증한다.
노트 이름을 바꾸고 참조를 안전하게 갱신하기에서는 title·파일 경로·aliases의 차이, 적용 전 영향 개수, Markdown·wiki 참조 rewrite, code 예외와 rollback을 3개 fixture 문서와 실제 앱 영상으로 검증한다.
Markdown을 Plain Text로 정리하기에서는 선택 영역·현재 문단·문서 전체의 범위 차이, 토큰 제거와 최소 구조 보존 규칙, frontmatter·block ID 경계를 3개 fixture와 단계별 이미지 11장, 실제 앱 영상 3개로 검증한다.
요약·슬라이드 메타데이터와 프로젝션 설정에서는 summary·pitch 배열을 속성에서 편집하고, 같은 Markdown을 슬라이드로 전환해 크기·색상·오버레이를 설정하면서 원문과 표현 상태가 분리되는 경계를 2개 fixture, 단계별 이미지 11장과 실제 앱 영상 2개로 검증한다.
문서를 드롭해 링크·임베드·본문으로 삽입하기에서는 Shelf의 Markdown을 편집기에 놓은 뒤 명시적 intent 메뉴에서 link, 참조 보기, embed, text copy를 고르는 흐름을 4개 fixture, 단계별 이미지 13장, 네이티브 확인 이미지 1장과 실제 앱 영상 3개로 검증한다.
실패와 복구
외부 편집 충돌, stale selection, 이미지 일부 저장 실패와 rename 중 참조 갱신 실패는 성공처럼 숨기지 않는다. 원본 다시 불러오기, 내 버전 유지, 사본 저장과 변경 버리기의 차이는 문서 저장·닫기·복구에서 확인한다.
기본 기능을 빠르게 찾으려면 Markdown 에디터 레퍼런스를 함께 사용한다.
대표 조작을 먼저 보기
이 장의 상세 절은 같은 원문을 편집하고, 구조를 이동하고, 재사용 가능한 note로 분리하는 과정을 실제 Desktop asset으로 증명한다.
대표 조작은 원문 변경과 session 상태를 분리해 기록한다. 예를 들어 section drag는 Markdown heading 순서를 바꾸지만 outline 접기·focus는 원문을 바꾸지 않는다.
작성 장의 공통 검증
- 저장 전후 Markdown diff를 확인한다.
- 새 note·link·embed가 생기면 경로와 provenance를 기록한다.
- rename·extract 실패 시 원문과 사본 저장 경로를 보존한다.
- front matter와 projection profile의 책임을 혼동하지 않는다.
- Hugo 결과가 Desktop의 selection·focus·검색 상태를 재현한다고 표현하지 않는다.