quillmark-cli-0.1.2 is not a library.

quillmark-cli

Minimal CLI for testing Quillmark packages locally.

Overview

quillmark-cli is a simple command-line tool for rendering Markdown files to PDF using Quillmark Typst quills. It's designed for local testing and development of quill templates.

Installation

cargo install quillmark-cli

Or install from source:

git clone https://github.com/nibsbin/quillmark
cd quillmark/quillmark-cli
cargo install --path .

Usage

The CLI requires both a markdown file and a quill path:

quillmark-cli <MARKDOWN_FILE> --quill-path <QUILL_DIR>

Command-Line Options

quillmark-cli [OPTIONS] --quill-path <QUILL_PATH> <MARKDOWN>

Arguments:
  <MARKDOWN>  Path to the markdown file to render

Options:
      --quill-path <QUILL_PATH>  Path to the quill directory
  -o, --output <OUTPUT>          Output PDF file path [default: output.pdf]
  -h, --help                     Print help

<MARKDOWN> - Path to the markdown file to render (required)
--quill-path <QUILL_DIR> - Path to the quill directory (required)
--output <OUTPUT_PDF> - Output PDF file path (default: output.pdf)

Quill Validation

If your markdown includes a QUILL field in the frontmatter, the CLI will warn you if it doesn't match the quill loaded from --quill-path. The quill specified by --quill-path is always used as the authoritative source.

Example warning:

Warning: Markdown specifies quill 'expected_quill' but using quill 'actual_quill' from --quill-path

Examples

Example 1: Basic Usage

Create my-memo.md:

---
from: HQ AFGSC/A3TW
to: ALL MAJCOM UNITS
subject: Test Memorandum
date: 2024-01-15
---

This is the body of the memorandum.

Render it:

quillmark-cli my-memo.md --quill-path ./quillmark-fixtures/resources/usaf_memo

This creates output.pdf using the specified quill.

Example 2: With Custom Output Path

quillmark-cli my-memo.md --quill-path ./my-quill --output my-memo.pdf

Example 3: With QUILL Field (Validation)

Create document.md:

---
QUILL: usaf_memo
from: HQ AFGSC/A3TW
to: ALL MAJCOM UNITS
subject: Test
---

Document content...