Quarkdown: 현대적인 Markdown 기반 조판 시스템

1 week ago 4

Quarkdown은 Markdown의 단순성과 함수, 스크립팅 확장 기능을 결합해, 책, 프레젠테이션 등 다양한 출력물 생성을 지원함
Turing-complete한 확장을 통해 조건문, 반복문, 레이아웃 함수를 제공하고, 자신만의 함수와 변수를 정의할 수 있음
HTML, PDF(책/슬라이드 포함)와 같은 폭넓은 지원 타겟과 빠른 컴파일, 라이브 프리뷰 기능을 보유함
LaTeX, Typst, MDX 등과 비교해 가독성, 문서 제어, 쉬운 러닝커브에서 우수한 경쟁력을 지님
사용자는 프로젝트 생성 마법사, REPL, 다양한 CLI 옵션으로 간편하게 입문하고 활용할 수 있음

Quarkdown 개요 및 주요 기능

About

Quarkdown은 현대적인 Markdown 기반 조판 시스템으로, 핵심 개념은 다재다능성임
책, 논문, 프레젠테이션 등 다양한 결과물을 손쉽게 만들 수 있도록 프로젝트를 컴파일함
Markdown을 Turing-complete하게 확장하여, 아이디어가 자연스럽게 문서로 이어지는 경험을 제공함

Quarkdown은 CommonMark, GFM을 확장한 새로운 Flavor로, 함수 및 새로운 구문을 도입함

함수 호출 예시: .somefunction {arg1} {arg2} Body argument

끊임없이 확장되는 표준 라이브러리에서 레이아웃 빌더, 입출력, 수학 연산, 조건문 및 반복문 등의 기능을 즉시 제공함
부족하다면, 사용자가 직접 함수, 변수를 정의하거나, 재사용 가능한 라이브러리를 만들 수 있음

예시:

.function {greet} to from: **Hello, .to** from .from! .greet {world} from:{iamgio}

결과: Hello, world from iamgio

이처럼 즉시 사용 가능한 스크립팅 지원으로 인해, 기존 Markdown으로는 불가능한 동적이고 복잡한 콘텐츠 작성도 가능함
라이브 프리뷰와 빠른 컴파일 속도와 결합해 효율적인 문서 제작을 지원함

기능 및 언어 구성에 대한 자세한 내용은 wiki 참고

데모 프레젠테이션

데모 페이지에서 Quarkdown 기반의 실제 프레젠테이션 확인 가능
소스코드는 demo/demo.qmd에서 열람 가능
데스크탑 뷰 권장

간단하지만, 복잡한 필요까지 충족

Quarkdown은 간단한 문서(책, 논문 등)뿐 아니라, 차트와 같은 복잡한 시각 요소도 출력 가능함

지원 대상(타겟)

HTML
- 일반 출력(기본값)
- 슬라이드( reveal.js 활용 )
- 책/논문 형태( paged.js 활용, 웹서버 필요 )
PDF
- HTML이 지원하는 모든 문서 유형, 기능을 그대로 PDF로 출력 가능
- PDF 출력에 관한 자세한 내용은 wiki 문서 참고

문서 출력 유형은 소스에서 .doctype {slides} 또는 .doctype {paged} 함수 호출로 지정 가능

비교

Quarkdown Markdown LaTeX Typst AsciiDoc MDX

간결함·가독성	✔	✔	✗	✔	✔	✔
전체 문서 제어	✔	✗	✔	✔	✗	✗
스크립팅 기능	✔	✗	일부 지원	✔	✗	✔
책/기사 형식 출력	✔	✗	✔	✔	✔	3rd party
프레젠테이션 출력	✔	✗	✔	✔	✔	3rd party
러닝 커브	초록	초록	빨강	주황	초록	초록
타겟 지원	HTML, PDF	HTML	PDF, PostScript	PDF	HTML, PDF, ePub	HTML