GitHub 'iamgio/quarkdown' 트렌딩…Markdown 기반 튜링 완전 식자 시스템, paged.js·reveal.js로 책·논문·슬라이드·위키 단일 소스 출력

Markdown 기반 튜링 완전 식자(typesetting) 시스템 'Quarkdown'이 깃허브 트렌딩에 등장했다. 한 프로젝트 소스를 인쇄용 도서·학술 논문·지식베이스·인터랙티브 프레젠테이션으로 모두 컴파일하도록 설계됐으며, CommonMark·GFM의 확장 'Quarkdown Flavor'에 함수와 다양한 문법 확장을 더한 것이 핵심이다.

Quarkdown은 마크다운 안에서 .somefunction {arg1} {arg2} 형식으로 함수를 호출하고, 이용자가 .function {greet} 형식으로 직접 함수와 변수를 정의할 수 있다. 표준 라이브러리는 레이아웃 빌더, I/O, 수학, 조건문, 반복문 등을 제공하며 외부에 라이브러리를 만들어 공유할 수도 있다고 프로젝트는 설명한다.

출력 형식은 HTML(Plain·Paged·Slides·Docs), PDF, 일반 텍스트가 지원되며, .doctype 함수로 plain(기본)·paged·slides·docs 중 선택한다. 페이지 처리는 paged.js, 슬라이드는 reveal.js를 활용하고, Plain은 Notion·Obsidian 스타일의 연속 흐름으로 정적 사이트와 지식 관리에 적합하다는 설명이다. PDF 내보내기는 HTML이 지원하는 모든 문서 유형·기능을 그대로 지원한다.

프로젝트가 첨부한 비교표에서는 Quarkdown을 LaTeX·Typst·AsciiDoc·MDX와 비교한다. Quarkdown은 'concise and readable', 'full document control', 'scripting', 'book/article export', 'presentation export', 'static site export', 'docs/wiki export'를 모두 지원한다고 표시했고, 학습 곡선은 가장 낮은 수준(녹색)으로 분류했다. 출력 타깃은 HTML·PDF·TXT다.

설치는 macOS의 brew install quarkdown-labs/quarkdown/quarkdown, 윈도우의 PowerShell irm 스크립트와 scoop install quarkdown 명령으로 가능하며, 리눅스는 install.sh를 sudo로 실행하면 /opt/quarkdown에 설치하고 /usr/local/bin/quarkdown에 래퍼 스크립트를 둔다. Java 17 이상이 필수이며, PDF 내보내기에는 Node.js·npm·Puppeteer가 추가로 필요하다.

CLI는 quarkdown create [디렉터리]로 메타데이터·초기 콘텐츠가 포함된 프로젝트를 마법사로 생성하고, quarkdown c file.qd로 컴파일, quarkdown repl로 인터랙티브 REPL을 실행한다. -p(자동 콘텐츠 새로고침)·-w(소스 변경 시 재컴파일) 옵션을 결합하면 라이브 프리뷰가 가능하며, --pdf 옵션으로 PDF 산출물을 생성한다.

라이선스는 기본적으로 GNU GPLv3이며, CLI 모듈(quarkdown-cli)과 Language Server 모듈(quarkdown-lsp) 및 바이너리에는 GNU AGPLv3이 적용된다. 깃허브 액션 통합용 setup-quarkdown 액션이 별도로 제공되며, 다양한 시각 요소를 한 번에 살펴볼 수 있는 예제 'Mock'이 mock 디렉터리에 포함돼 있어 quarkdown c mock/main.qd -p 명령으로 바로 실행해 볼 수 있다.