marp-generator

A simple tool to generate HTML and PDF presentations from a directory of MARP markdown files (instead of generating them one at a time).

Installation

npm install marp-generator

Usage

import marpGenerate from 'marp-generator';

await marpGenerate({
  inputDirectory: './presentations',
  outputDirectory: './output',
  generatePDFs: true // optional, defaults to false
});

Options

• inputDirectory (required): Path to directory containing markdown files
• outputDirectory (required): Path to output directory
• generatePDFs (optional): Whether to generate PDF files (default: false)

Features

• Generates HTML presentations from MARP markdown files
• Optionally generates PDF files
• Automatically copies asset directories
• Skips files starting with underscore (useful for unpublished presentations)

Example

Given a directory structure like:

presentations/
  ├── 01_intro.md
  ├── 02_topics.md
  └── assets/
      └── images/

The generator will:

1. Convert each .md file to HTML (and optionally PDF)
2. Copy the assets directory to the output directory
3. Skip any files starting with _ (e.g., _template.md)

Requirements

• Node.js 14+ (for ES modules support)
• MARP markdown files with proper frontmatter

License

ISC