Quarkdown: 하나의 마크다운으로 책, 논문, 문서, 발표 자료까지 만드는 차세대 문서 작성 시스템

이 글에서는 Quarkdown이라는 최신 Markdown 기반 문서 조판(typesetting) 시스템을 소개합니다.
Quarkdown은 하나의 소스 파일로 책, 학술 논문, 기술 문서, 위키, 프레젠테이션까지 다양한 형태의 결과물을 만들어낼 수 있는 도구입니다. 기존 Markdown의 단순함은 유지하면서도, 함수·변수·조건문·반복문까지 지원하는 확장 문법을 통해 훨씬 강력한 문서 작성 경험을 제공합니다. 이 글에서는 Quarkdown의 개념, 등장 배경, 핵심 특징, 지원 포맷, 다른 도구와의 비교, 그리고 실제 사용 방법까지 정리해 보겠습니다.

반응형

---

Quarkdown이란 무엇인가

Quarkdown은 Markdown 기반의 현대적인 문서 조판 시스템입니다.
단순히 글을 작성하는 수준을 넘어, 하나의 프로젝트를 다음과 같은 형태로 컴파일할 수 있습니다.

• 인쇄 가능한 책 또는 논문
• 기술 문서 및 대규모 지식 베이스
• 정적 웹 페이지
• 인터랙티브 프레젠테이션
• PDF 및 일반 텍스트 문서

이 모든 작업을 하나의 Markdown 프로젝트에서 처리할 수 있다는 점이 Quarkdown의 가장 큰 특징입니다.

---

등장 배경과 철학

Quarkdown은 CommonMark와 GitHub Flavored Markdown(GFM)을 확장한 Quarkdown Flavor를 기반으로 합니다.
기존 Markdown은 읽기 쉽고 작성이 빠르지만, 복잡한 문서 구조나 동적인 콘텐츠를 표현하는 데 한계가 있었습니다.

Quarkdown은 이 문제를 해결하기 위해 다음과 같은 방향성을 가집니다.

• Markdown의 가독성과 단순함 유지
• 문서 전체를 제어할 수 있는 강력한 표현력
• 자동화와 재사용이 가능한 문서 작성
• 아이디어가 곧바로 결과물로 이어지는 흐름

즉, “글을 쓰는 행위”와 “출판을 위한 문서 작업” 사이의 간극을 줄이기 위한 도구라고 볼 수 있습니다.

---

Quarkdown의 핵심 개념: 함수가 있는 Markdown

Quarkdown의 가장 큰 차별점은 Turing-complete 확장 문법입니다.
Markdown 안에서 다음과 같은 작업이 가능합니다.

1. 함수 호출

.somefunction {arg1} {arg2}
    Body argument

2. 사용자 정의 함수와 변수

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

.greet {world} from:{iamgio}

결과:

Hello, world from iamgio!

이러한 기능을 통해 반복되는 레이아웃, 템플릿, 문서 구성 요소를 재사용할 수 있으며, 조건문과 반복문을 활용한 동적 문서 생성도 가능합니다.

---

표준 라이브러리와 확장성

Quarkdown은 기본적으로 다양한 표준 라이브러리를 제공합니다.

• 레이아웃 빌더
• 입출력(I/O)
• 수학 표현
• 조건문 및 반복문

여기에 더해, 사용자가 직접 함수를 정의하고 라이브러리로 만들어 공유할 수도 있습니다.
즉, 단순한 문서 작성 도구를 넘어 문서 중심의 스크립팅 환경이라고 볼 수 있습니다.

---

라이브 프리뷰와 개발 경험

Quarkdown은 빠른 컴파일 속도와 함께 라이브 프리뷰 기능을 제공합니다.
특히 Visual Studio Code 확장과 결합하면 다음과 같은 장점이 있습니다.

• 문서 수정 즉시 결과 확인
• 복잡한 문서 구조도 빠르게 검증
• 학술 논문, 책, 기술 문서 작업에 적합한 워크플로우

이러한 환경 덕분에 작성자는 형식보다 내용에 집중할 수 있습니다.

---

지원 출력 포맷(Targets)

Quarkdown은 다양한 출력 포맷을 지원합니다.

HTML 계열

• Plain: 연속 흐름 문서 (정적 사이트, 지식 관리용)
• Paged (paged.js): 논문, 기사, 책에 적합
• Slides (reveal.js): 인터랙티브 프레젠테이션
• Docs: 위키 및 대규모 기술 문서

PDF

• HTML에서 지원하는 모든 문서 유형을 PDF로 변환 가능

Plain Text

• 텍스트 기반 결과물 생성 가능

문서 유형은 소스 내에서 다음과 같이 지정합니다.

.doctype {plain}
.doctype {paged}
.doctype {slides}
.doctype {docs}

---

다른 문서 도구와의 비교

Quarkdown은 LaTeX, Typst, AsciiDoc, MDX와 비교했을 때 다음과 같은 강점을 가집니다.

• Markdown 기반으로 간결하고 읽기 쉬움
• 문서 전체 제어 가능
• 스크립팅 지원
• 책, 논문, 프레젠테이션, 문서 사이트까지 단일 도구로 처리
• 비교적 완만한 학습 곡선
• HTML, PDF, TXT 등 다양한 출력 대상 지원

특히 “하나의 소스로 여러 결과물을 만든다”는 점에서 실무 문서 자동화에 적합합니다.

---

설치 방법 요약

Quarkdown은 다양한 환경에서 설치할 수 있습니다.

Linux / macOS

• 설치 스크립트
• Homebrew

Windows

• PowerShell 설치 스크립트
• Scoop 패키지 매니저

설치 과정에서는 필요한 경우 Java 17, Node.js, npm이 자동으로 설치됩니다.

---

빠르게 시작하기: 기본 사용 흐름

1. 프로젝트 생성

quarkdown create [directory]

프롬프트 기반 마법사를 통해 메타데이터와 초기 파일이 자동으로 생성됩니다.

2. 컴파일

quarkdown c file.qd

3. 라이브 프리뷰

quarkdown c file.qd -p -w

• -p: 프리뷰 활성화
• -w: 파일 변경 시 자동 재컴파일

이를 통해 실시간 문서 확인이 가능합니다.

---

Mock 문서로 기능 살펴보기

Quarkdown은 언어에서 제공하는 다양한 시각 요소를 모아둔 Mock 문서를 제공합니다.
페이지 또는 슬라이드 형태로 컴파일해 보면서 실제 결과물을 기준으로 기능을 이해할 수 있습니다.

quarkdown c mock/main.qd -p

---

728x90

Quarkdown은 단순한 Markdown 도구가 아닙니다.
하나의 문서 소스로 다양한 결과물을 만들고, 반복 작업을 자동화하며, 복잡한 문서 구조까지 제어할 수 있는 차세대 문서 작성 플랫폼입니다.

특히 다음과 같은 사용자에게 의미 있는 선택지가 될 수 있습니다.

• 학술 논문과 책을 함께 관리해야 하는 연구자
• 기술 문서와 위키를 운영하는 개발팀
• 발표 자료와 문서를 동시에 관리해야 하는 실무자

앞으로 문서 작성이 단순한 기록을 넘어 자동화와 재사용의 영역으로 확장되는 흐름 속에서, Quarkdown은 충분히 주목할 만한 도구입니다.

300x250

https://github.com/iamgio/quarkdown

GitHub - iamgio/quarkdown: 🪐 Markdown with superpowers: from ideas to papers, presentations, websites, books, and knowledge b