🪐 Quarkdown — 아이디어에서 프레젠테이션, 기사, 책까지, 슈퍼파워를 가진 마크다운
공식 사이트: quarkdown.com
소개
Quarkdown은 마크다운(Markdown)에 강력한 기능을 더한 오픈소스 마크업 언어입니다. 문서, 프레젠테이션, 논문, 책 등 다양한 형태로 손쉽게 변환할 수 있으며, 스크립팅, 타입세팅, PDF/HTML 변환 등 다양한 기능을 제공합니다.
주요 특징
- 간결하고 읽기 쉬운 문법
- 전체 문서 제어(슬라이드, 책, 논문 등)
- 스크립팅 지원
- 책/기사/프레젠테이션 내보내기
- 쉬운 학습 곡선
- 다양한 출력 타겟: HTML, PDF 등
비교표
| Quarkdown | Markdown | LaTeX | Typst | AsciiDoc | MDX |
|---|---|---|---|---|---|
| 간결하고 읽기 쉬움 | ✅ | ✅ | ❌ | ✅ | ✅ |
| 전체 문서 제어 | ✅ | ❌ | ✅ | ✅ | ❌ |
| 스크립팅 | ✅ | ❌ | 일부 | ✅ | ❌ |
| 책/기사 내보내기 | ✅ | ❌ | ✅ | ✅ | ✅ |
| 프레젠테이션 내보내기 | ✅ | ❌ | ✅ | ✅ | ✅ |
| 학습 곡선 | 🟢 | 🟢 | 🔴 | 🟠 | 🟢 |
| 출력 타겟 | HTML, PDF | HTML | PDF, PostScript | HTML, PDF, ePub |
설치 및 시작하기
설치
- 최신 릴리즈에서
quarkdown.zip을 다운로드하거나,gradlew distZip으로 직접 빌드 후 압축을 해제하세요. bin디렉토리에는 실행 스크립트가 있습니다. PATH에 추가하면 더 편리하게 사용할 수 있습니다.lib/qmd디렉토리에는 프로젝트에 import할 수 있는.qmd라이브러리가 있습니다.- Java 17 이상 필요. 모든 주요 OS 지원.
프로젝트 생성
quarkdown create [디렉토리]명령어로 프롬프트 기반 프로젝트 생성 마법사를 실행할 수 있습니다.- 수동으로
.qmd소스 파일을 만들어 시작할 수도 있습니다.
컴파일
quarkdown c file.qmd명령어로 파일을 컴파일하여 결과물을 생성합니다.- 여러 소스 파일로 구성된 프로젝트라면, 루트 파일(다른 파일을 포함하는 파일)을 지정해야 합니다.
quarkdown repl로 대화형 REPL 모드에서 실험할 수도 있습니다.
주요 옵션
-p,--preview: 컴파일 후 자동 미리보기 및 웹서버 실행-w,--watch: 소스 디렉토리 변경 시 자동 재컴파일--pdf: PDF 파일 생성-o <dir>,--output <dir>: 출력 디렉토리 지정(기본값: ./output)-l <dir>,--libs <dir>: 외부 라이브러리 디렉토리 지정-r <renderer>,--render <renderer>: 렌더러 지정(기본값: html, html-pdf 등)--server-port <port>: 웹서버 포트 지정(기본값: 8089)--pretty: 보기 좋은 코드 출력(디버깅용)--clean: 출력 디렉토리 초기화 후 새로 생성--strict: 에러 발생 시 프로그램 종료(기본은 에러를 문서 내 박스로 표시)--no-media-storage: 미디어 저장 시스템 비활성화-Dloglevel=<level>: 로그 레벨 지정
문서 유형 및 PDF
.doctype {slides}또는.doctype {paged}로 문서 유형 지정 가능- HTML에서 지원되는 모든 기능은 PDF 내보내기에서도 지원됨
Mock 문서
- Quarkdown으로 작성된 Mock 문서는 언어의 시각적 요소를 종합적으로 보여주는 예시입니다.
mock디렉토리의 소스 파일을quarkdown c mock/main.qmd -p로 컴파일할 수 있습니다.- 다양한 테마 조합의 PDF 결과물은 generated 브랜치에서 확인 가능
기여하기
- 기여를 환영합니다! 이슈, PR 등은 CONTRIBUTING.md를 참고하세요.
스폰서
- 프로젝트를 후원해주신 모든 분들께 감사드립니다!
- LunaBluee, dcopia 등
컨셉
- 로고는 오리지널 마크다운 아이콘을 연상시키며, Quarkdown의 완성도, 풍부한 기능, 커스터마이즈 가능성을 강조합니다.
- 구체적으로는 쿼크(quark), 특히 다운 쿼크(down quark)에서 영감을 받았습니다. 다운 쿼크는 물질의 주요 구성 입자이자, 존재하는 가장 가벼운 객체 중 하나입니다.
- Quarkdown은 바로 이 개념 위에 구축되었습니다.
라이선스 및 기타 정보
- GPL-3.0 라이선스
- 별 3.7k, 포크 60
- 주요 언어: Kotlin, HTML, CSS, JavaScript
- README.md
© 2025 GitHub, Inc.
반응형
