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

Marp Processor

Purpose

Converts Markdown slides to PDF, PPTX, or HTML using Marp.

How It Works

Discovers .md files in the project and runs marp on each file, generating output in the configured formats. Each format produces a separate output file.

Source Files

  • Input: **/*.md
  • Output: out/marp/{format}/{relative_path}.{format}

Configuration

[processor.marp]
marp_bin = "marp"                      # The marp command to run
formats = ["pdf"]                      # Output formats (pdf, pptx, html)
args = ["--html", "--allow-local-files"]  # Additional arguments to pass to marp
output_dir = "out/marp"                # Output directory
extra_inputs = []                      # Additional files that trigger rebuilds when changed
KeyTypeDefaultDescription
marp_binstring"marp"The marp executable to run
formatsstring[]["pdf"]Output formats to generate (pdf, pptx, html)
argsstring[]["--html", "--allow-local-files"]Extra arguments passed to marp
output_dirstring"out/marp"Base output directory
extra_inputsstring[][]Extra files whose changes trigger rebuilds