Ilgi(읽기) — 마크다운을 깔끔하게 읽는 기술.

GitHub 스타일의 마크다운 렌더링을 충실히 재현하여 깔끔한 읽기 경험을 제공하는 로컬 앱입니다.

마크다운은 단순한 경량 마크업 언어를 넘어, 개발자 세계에서 문서화, 커뮤니케이션, 사고의 매체가 되었습니다. 최근에는 AI에이전트의 지식데이터가 마크다운으로 제공됨에 따라 일반인들도 마크다운을 알게 되어 생성되는 MD파일을 알지만 깔끔하게 읽어볼 수 있는 앱이 부재한 상태입니다. 대부분의 도구가 마크다운 작성 에 초점을 맞추는 반면, Ilgi(읽기)는 마크다운을 아름답게 읽는 것 을 위해 설계되었습니다.

"Ilgi(읽기)"라는 이름은 "읽는 기술"에서 비롯되었으며, 마크다운을 읽는 행위가 단순한 실용적 작업이 아니라 조용하고 의도적인 이해와 감상의 행위라는 철학을 담고 있습니다.

Ilgi는 로컬 오프라인 환경에서 GitHub의 마크다운 렌더링을 충실히 재현하며, 깔끔한 타이포그래피와 균형 잡힌 여백으로 차분하고 정확한 읽기 경험을 제공합니다.

• GitHub 스타일 렌더링 — 확장 문법을 완벽히 지원하는 정확한 GitHub 마크다운 스타일 재현
• 네이티브 성능 — Rust로 구축된 빠르고 반응성 높은 렌더링
• 자동 새로고침 — 디스크에서 파일이 변경되면 자동으로 업데이트
• 오프라인 우선 — 인터넷 연결 불필요 — 언제 어디서나 문서를 읽을 수 있습니다

• 파일 탐색기 — 로컬 디렉토리를 탐색할 수 있는 내장 사이드바 파일 트리
• 빠른 접근 — 자주 사용하는 파일과 디렉토리를 즐겨찾기에 등록하여 즉시 접근
• 디렉토리 히스토리 — 사이드바 파일 탐색기 내 뒤로/앞으로 탐색
• 목차 — 문서 내 쉬운 탐색을 위한 자동 TOC 패널
• 실시간 탐색 — 연결된 마크다운 문서 간 히스토리 지원(뒤로/앞으로) 탐색

• 페이지 내 검색 — Cmd+F로 문서 내 검색
• 고정 검색 — 검색 쿼리를 고정하여 세션 간 지속되는 다중 색상 하이라이트

• 탭 지원 — 하나의 창에서 여러 문서를 탭으로 열고 관리
• 다중 창 — 여러 창을 생성하고 다이어그램용 자식 창 열기
• 창 간 탭 이동 — 창 사이에서 탭을 드래그 앤 드롭
• 드래그 앤 드롭 — 마크다운 파일을 창에 끌어다 놓기만 하면 열기

• Mermaid 다이어그램 — 확대/축소, 이동, 이미지 복사가 가능한 인터랙티브 다이어그램 뷰어
• 수식 표현 — KaTeX를 활용한 아름다운 수학 표기법 렌더링
• 코드 하이라이트 — 코드 블록에 구문 강조와 복사 버튼 제공
• Frontmatter — YAML 프론트매터를 스타일링된 접이식 테이블로 렌더링
• GitHub Alerts — NOTE, TIP, IMPORTANT, WARNING, CAUTION 알림 완벽 지원

• 다크 모드 — 시스템 환경설정에 따른 수동 및 자동 테마 전환
• 줌 컨트롤 — 키보드 단축키와 트랙패드 제스처로 확대/축소
• 환경설정 — 사이드바, TOC 등 다양한 설정 구성
• 컨텍스트 메뉴 — 파일과 콘텐츠에 대한 빠른 작업을 위한 우클릭 메뉴

Homebrew tap을 사용하여 설치합니다. 이 애플리케이션은 Apple 개발자 ID로 서명 및 공증되지 않았으므로, 설치 후 격리 속성을 제거해야 합니다. 자세한 내용은 homebrew-tap을 참고하세요.

brew install --cask gaebalai/tap/Ilgi
xattr -dr com.apple.quarantine /Applications/Ilgi.app

또는 Nix도 지원됩니다. 영구 설치 없이 사용해 보려면:

nix run github:gaebalai/Ilgi

영구 설치는 nix-darwin 또는 home-manager를 사용하세요. flake inputs에 다음을 추가합니다:

Ilgi.url = "github:gaebalai/Ilgi";

그런 다음 environment.systemPackages (nix-darwin) 또는 home.packages (home-manager)에 추가합니다:

environment.systemPackages = [ inputs.Ilgi.packages.${system}.default ];

애플리케이션을 실행하면 키보드 단축키와 사용 방법이 포함된 환영 화면이 표시됩니다.

설치 후 터미널에서 Ilgi 명령어를 사용할 수 있습니다:

Ilgi                     # Ilgi 실행 (환영 화면 표시)
Ilgi README.md           # 특정 파일 열기
Ilgi --open=screen README.md
Ilgi --open=new README.md
Ilgi --directory=. README.md
Ilgi docs/               # 파일 탐색기에서 디렉토리 열기
Ilgi file1.md file2.md   # 여러 파일을 탭으로 열기

Ilgi는 단일 인스턴스로 실행됩니다 — Ilgi가 이미 실행 중이면, 새 프로세스를 시작하는 대신 기존 프로세스에 요청을 전달합니다.

• Ilgi FILE은 기본적으로 last_focused 동작을 사용합니다 (마지막으로 포커스된 표시 중인 창 재사용).
• --open=screen은 커서가 있는 현재 화면의 표시 중인 창을 열거나 재사용합니다.
• --open=new는 항상 새 창에서 엽니다.
• --directory=DIR은 해당 호출의 파일 탐색기 루트 디렉토리를 설정합니다.
• 위치 인자로 디렉토리를 전달하면 (예: Ilgi docs/) 루트 디렉토리도 설정됩니다.
• 인자 없이 Ilgi를 실행하면 숨겨진 기존 창을 표시/포커스하거나, 없으면 새 창을 엽니다.

스크린샷, 주요 기능 소개 등은 준비중를 방문하세요.

개발 환경 설정 및 가이드라인은 CONTRIBUTING.md를 참고하세요.

자세한 내용은 LICENSE 파일을 참고하세요.