Markdown2html Processor

Purpose

Converts Markdown files to HTML using the markdown Perl script.

The Rust alternative is imarkdown2html: Markdown converted in-process with pulldown-cmark, no Perl script. pulldown-cmark follows CommonMark, so its HTML can differ from the markdown script’s in the corners where the two disagree. Switching is markdown2html → imarkdown2html in the stanza header.

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/processor.generator.markdown2html/{relative_path}.html

Configuration

[processor.generator.markdown2html]
command = "markdown"                   # The markdown command to run
args = []                              # Additional arguments to pass to markdown
output_dir = "out/processor.generator.markdown2html"       # Output directory
dep_inputs = []                      # Additional files that trigger rebuilds when changed

Batch support

Each input file is processed individually, producing its own output file.

Clean behavior

This processor is a Generator — rsconstruct clean outputs removes each declared output file individually with no directory recursion. After all per-product cleans complete, the orchestrator removes any parent directories that are now empty. Pass --no-empty-dirs to keep them. See Clean behavior and rsconstruct clean.