# summary

Render workspace markdown as a PDF document or interactive HTML deck.

# description

Choose exactly one output format: `--pdf` renders a linear PDF document, while `--deck` renders a self-contained interactive HTML presentation. Both formats render embedded Mermaid diagrams and inline local images.

# examples

- Create an interactive deck from a markdown file:

  <%= config.bin %> <%= command.id %> --deck --input presentation.md --output presentation.html --review presentation-review.json

- Create a PDF document from every markdown file under a directory:

  <%= config.bin %> <%= command.id %> --pdf --input docs --output documentation.pdf --review documentation-review.json

# flags.input.summary

Directory of markdown files, or a comma-separated list of markdown files.

# flags.input.description

A directory is walked recursively for `*.md` and `*.markdown` files and sorted. A comma-separated list preserves the given order.

# flags.output.summary

Path to write the generated PDF or HTML deck.

# flags.output.description

When omitted, writes `document-<timestamp>.pdf` or `deck-<timestamp>.html` in the current directory.

# flags.review.summary

Path to the approved document quality review JSON.

# flags.review.description

Required for every render. The review must approve the exact ordered input files and SHA-256 source digest, use an independent reviewer, and contain no open blocking findings.

# flags.deck.summary

Render an interactive Salesforce-branded HTML deck.

# flags.deck.description

Splits markdown at each top-level heading (`#`) and adds previous/next controls, keyboard navigation, URL slide hashes, and fullscreen mode. Deck output is always self-contained HTML.

# flags.pdf.summary

Render a linear PDF document.

# flags.pdf.description

Consolidates the markdown into a Salesforce-branded PDF. Use `--deck` instead for an interactive HTML presentation.

# info.done

Wrote %s (%s markdown file(s) consolidated).

# error.noFiles

No markdown files matched: %s

# error.outputExtension

The %s format requires an %s output path: %s

# error.puppeteer

%s

The PDF step needs Chromium via puppeteer — install it with: npm install puppeteer

# error.review

Document quality gate failed: %s