Keyboard shortcuts

Press or to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Chromium Processor

Purpose

Converts HTML files to PDF using headless Chromium (Google Chrome).

How It Works

Discovers .html files in the configured scan directory (default: out/marp) and runs headless Chromium with --print-to-pdf on each file, producing a PDF output.

This is typically used as a post-processing step after another processor (e.g., Marp) generates HTML files.

Source Files

  • Input: out/marp/**/*.html (default scan directory)
  • Output: out/chromium/{relative_path}.pdf

Configuration

[processor.chromium]
chromium_bin = "google-chrome"            # The Chromium/Chrome executable to run
args = []                                 # Additional arguments to pass to Chromium
output_dir = "out/chromium"               # Output directory for PDFs
extra_inputs = []                         # Additional files that trigger rebuilds when changed
KeyTypeDefaultDescription
chromium_binstring"google-chrome"The Chromium or Google Chrome executable
argsstring[][]Extra arguments passed to Chromium
output_dirstring"out/chromium"Base output directory for PDF files
extra_inputsstring[][]Extra files whose changes trigger rebuilds