STABLE v1.5.17 RELEASE

UNDER THE HOOD.

STACK: TypeScript, Node.js
CORE: Pandoc API
ARCH: Modular CLI
01

Core Architecture

NpxMagicDoc은 마크다운 파싱과 문서 생성을 분리한 계층형 아키텍처를 따릅니다. Pandoc 엔진의 추상화 계층을 통해 다양한 포맷으로의 확장이 용이합니다.

Markdown Input (CommonMark)
AST Parser & Sanitize Layer
Theme Injector (CSS/Templates)
Pandoc Bridge Executor
Output (EPUB / PDF / DOCX)
02

Module Specifications

Converter Core

TypeScript 인터페이스를 통해 Pandoc 명령어 옵션을 객체 지향적으로 래핑합니다. 복잡한 CLI 인자를 데이터 구조로 관리합니다.

Theme Engine

JSON 기반의 테마 정의 시스템을 사용합니다. 각 테마는 폰트, 컬러셋, HTML 템플릿 경로를 포함하며 동적으로 로드됩니다.

Pre-processor

Obsidian 특화 문법(Wikilink, Callout)을 Pandoc이 이해할 수 있는 표준 마크다운으로 변환하는 정규식 기반 처리기입니다.

03

Advanced CLI API

자동화 파이프라인(CI/CD) 구성을 위해 대화형 모드 외에 직접 명령형 인자를 지원합니다.

bash cli_spec.sh
npx markdown-to-document-cli convert \
  --input ./manuscript.md \
  --output ./build/book.epub \
  --theme apple-white \
  --cover ./assets/cover.png \
  --no-toc
04

Contribution Workflow

Local Development Setup

# Repository Clone
git clone https://github.com/goodlookingprokim/markdown-to-document-cli.git

# Dependency Install
npm install

# Run in Development Mode
npm run dev

# Build for Distribution
npm run build

새로운 테마 기여 시 /src/themes 디렉토리에 CSS와 템플릿 파일을 추가하고 themes.json에 메타데이터를 등록하십시오.