# Markdown 뷰어 — Liu Terminal

> Liu Terminal 마크다운 뷰어. 라이브 미리보기, 구문 강조, GitHub 스타일 서식으로 .md 파일을 터미널 내에서 렌더링하세요.

URL: https://liu.software/ko/docs/markdown/  
Language: ko  
Updated: 2026-10-17

Liu 안에서 README, 설계 노트, 에이전트 출력을 읽습니다 — 이미지, 표, 작업 목록, 위키링크, 코드 블록이 있는 스타일 렌더링과 원본 토글, 문서 내 검색을 제공합니다.

**재작성 중입니다.** 파서와 렌더러는 src/ui/markdown/에 있습니다(md\_parse.c, md\_render.c, md\_image.c, md\_graph.c, md\_math.c, md\_diagram.c). 뷰어 통합은 src/ui/filebrowser.c에 있으며 AST 형태와 이미지 파이프라인이 바뀔 수 있습니다.

## 문서 열기

파일 브라우저에서 .md 또는 .markdown 파일을 클릭하세요. Liu는 버퍼를 제자리에서 파싱하고(AST 슬라이스가 로드된 파일 텍스트를 가리킴) 동일한 터미널 폰트 아틀라스로 글리프를 렌더링하며 부드러운 픽셀 스크롤로 블록을 배치합니다.

원시 모드로 전환하면 코드 뷰와 동일한 찾기/바꾸기 기계를 사용하는 줄 기반 편집기에서 소스를 편집할 수 있습니다. 저장하지 않은 편집은 디스크에 쓸 때까지 수정됨으로 표시됩니다.

## 현재 렌더링 항목

- 제목, 단락, 강조, 취소선, 인라인 코드, 링크, 자동 링크, 이미지(로드 시 로컬 경로 해석).
- 블록별 Copy 버튼이 있는 펜스 코드 블록, 표, 글머리/번호/작업 목록(체크박스 클릭 가능).
- 콜아웃, 인용 블록, 위키링크/\[\[임베드\]\], #태그, 각주 참조.
- 수식과 다이어그램 블록은 md\_math.c / md\_diagram.c를 거칩니다(커버리지 확장 중).

## 확장 구문 및 제한

네이티브 파서는 YAML frontmatter(title, tags, aliases 포함), 정의 목록, 각주 정의 및 인라인 각주, ==강조==, ^위 첨자^, ~아래 첨자~, \<details\> 블록과 Mermaid 다이어그램의 네이티브 하위 집합도 지원합니다. raw HTML은 흐린 고정폭 텍스트로 표시되며 스크립트는 실행되지 않습니다.

## 탐색 도구

- ⌘ K → Go to Heading은 렌더마다 수집된 개요로 이동합니다(최대 512개 제목).
- ⌘ K → Open Note는 Notes Vault 아래 markdown 파일을 퍼지 검색으로 엽니다.
- ⌘ K → Search Notes는 팔레트에서 금고 파일 내용을 검색합니다.
- 문서 내 찾기/바꾸기는 렌더/원시 모드에서 동작합니다(트랙패드 스크롤은 팔레트처럼 픽셀을 누적 — 틱당 약 24–40px).

## 지식 그래프

Graph View(Vault) 또는 Graph Current Folder는 markdown 파일의 force-directed 그래프를 만듭니다. 위키링크, 태그, 고아 필터는 그래프 설정 패널에서 조정할 수 있습니다. 레이아웃 워커는 비동기로 실행되어 큰 금고에서도 UI가 멈추지 않습니다.

[다음 명령 팔레트 →](https://liu.software/ko/docs/palette.md)