🔥 DocForge

Forge beautiful PDFs from Markdown and HTML — perfect for LLM-generated documents, presentations, and reports.

Features

• 📝 Convert Markdown to PDF with syntax highlighting
• 🌐 Convert HTML to PDF with full CSS support
• 🎨 9 built-in styles: minimal, professional, presentation, invoice, dark, academic, report, resume, and mmd-brand
• 📚 Merge multiple files into a single PDF with optional table of contents
• ⚙️ Configurable via CLI options or config file
• 🔄 Watch mode for live regeneration
• 📦 Batch conversion support

Installation

npm install -g docforge-cli

Quick Start

# Convert a markdown file to PDF
docforge md document.md

# Convert with a specific style
docforge md report.md --style professional

# Convert HTML to PDF
docforge html page.html -o output.pdf

# Merge multiple files into one PDF
docforge merge chapter1.md chapter2.md chapter3.md -o book.pdf

# Merge with table of contents
docforge merge *.md -o combined.pdf --toc

Commands

docforge md <input> / docforge markdown <input>

Convert Markdown file(s) to PDF.

docforge md README.md                      # Basic conversion
docforge md doc.md -o output.pdf           # Specify output
docforge md doc.md --style dark            # Use dark theme
docforge md doc.md --format Letter         # US Letter size
docforge md doc.md --landscape             # Landscape orientation
docforge md doc.md --toc                   # Include table of contents
docforge md doc.md -w                      # Watch for changes

docforge html <input>

Convert HTML file(s) to PDF.

docforge html page.html                    # Basic conversion
docforge html page.html --style minimal    # Inject a style
docforge html page.html --wait 2000        # Wait for JS rendering
docforge html page.html --selector ".ready" # Wait for element

docforge merge <files...>

Merge multiple markdown files into a single PDF.

docforge merge ch1.md ch2.md ch3.md -o book.pdf
docforge merge *.md -o combined.pdf --toc  # With table of contents
docforge merge docs/*.md --sort            # Sort alphabetically
docforge merge *.md --style academic       # Use academic style

docforge styles

List all available built-in styles.

docforge init

Create a docforge.config.js configuration file.

docforge batch <pattern>

Convert multiple files matching a pattern.

docforge batch "*.md" -o ./pdfs
docforge batch "docs/*.html" -t html

Markdown Features

Page Breaks

DocForge supports Pandoc-style page breaks in your markdown files. Use \newpage or \pagebreak on its own line to force a page break:

# Chapter 1

Content of chapter 1...

\newpage

# Chapter 2

Content of chapter 2 starts on a new page.

Both \newpage and \pagebreak work identically. This ensures compatibility with documents that also need to render through Pandoc.

When merging multiple files with docforge merge, page breaks are automatically inserted between files by default. Use --no-auto-page-break to disable this behaviour.

Built-in Styles

| Style | Description | |-------|-------------| | minimal | Clean, simple styling with good typography | | professional | Business-ready documents with subtle accents | | presentation | Slide-like layout for presentations and decks | | dark | Dark mode theme for screen-friendly PDFs | | academic | Academic paper style (Times New Roman, double-spaced) | | report | Corporate report style with cover page support | | resume | Clean CV/resume layout | | invoice | Clean invoice and billing document style | | mmd-brand | Make More Digital branded documents |

Configuration

Create a docforge.config.js file in your project root:

module.exports = {
  style: 'professional',
  format: 'A4',
  landscape: false,
  markdown: {
    toc: false,
    headerFooter: true,
  },
  html: {
    wait: 0,
    selector: null,
  },
  customCss: '',
};

Programmatic Usage

const { convertMarkdown, convertHtml, mergeMarkdownFiles } = require('docforge-cli');

// Convert markdown
await convertMarkdown('input.md', { style: 'professional', output: 'output.pdf' });

// Convert HTML
await convertHtml('page.html', { format: 'Letter' });

// Merge files
await mergeMarkdownFiles(['ch1.md', 'ch2.md'], { toc: true, output: 'book.pdf' });

Requirements

• Node.js >= 18.0.0
• Chromium (automatically installed with Puppeteer)

License

MIT © Make More Digital

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.