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

Markdown Processor

Purpose

Converts Markdown files to HTML using the markdown Perl script.

How It Works

Discovers .md files in the project and runs markdown on each file, producing an HTML output file.

Source Files

  • Input: **/*.md
  • Output: out/markdown/{relative_path}.html

Configuration

[processor.markdown]
markdown_bin = "markdown"              # The markdown command to run
args = []                              # Additional arguments to pass to markdown
output_dir = "out/markdown"            # Output directory
extra_inputs = []                      # Additional files that trigger rebuilds when changed
KeyTypeDefaultDescription
markdown_binstring"markdown"The markdown executable to run
argsstring[][]Extra arguments passed to markdown
output_dirstring"out/markdown"Output directory for HTML files
extra_inputsstring[][]Extra files whose changes trigger rebuilds