@x12i/mdreports-cli

Command-line interface for Markdown Reports Studio. Renders Markdown to PDF, DOCX, PPTX, or HTML and manages templates.

Install

npm install -g @x12i/mdreports-cli
# or one-shot:
npx @x12i/mdreports-cli --help

PDF export needs Playwright Chromium once:

npx playwright install chromium

Render

mdreports render --in report.md --template clean-report --format pdf --out report.pdf
mdreports render --in report.md --template clean-report --format docx
mdreports render --in report.md --template clean-report --format pptx
mdreports render --in report.md --template letter --format html --out report.html

| Option | Description | | --- | --- | | --in <file> | Input Markdown file (required) | | --template <id> | Template id (required) | | --format <pdf\|docx\|html\|pptx> | Output format (default pdf) | | --out <file> | Output path (default: same name as input with new extension) | | --templates-dir <dir> | Override user templates directory |

Templates

mdreports templates list
mdreports templates show clean-report
mdreports templates create-from-html --id my-layout --name "My Layout" --layout layout.html --styles styles.css
mdreports templates create-from-image --id from-shot --name "From Shot" --image design.png
mdreports templates delete my-layout

create-from-image requires ANTHROPIC_API_KEY (or --anthropic-api-key).

Environment variables

| Variable | Purpose | | --- | --- | | MDREPORTS_TEMPLATES_DIR | User templates directory (default ~/.mdreports/templates) | | ANTHROPIC_API_KEY | For AI template creation from images |

Programmatic alternative

Prefer @x12i/mdreports-core when embedding rendering in your own Node.js app.