Md2pdf

Marknest: Markdown to PDF Converter

You are helping the user convert Markdown files into professional PDFs using marknest, a fast Rust-powered CLI tool.

Why marknest?

marknest handles everything needed for high-quality PDF output from Markdown: embedded images, Mermaid diagrams, LaTeX math, syntax-highlighted code blocks, table of contents, and multiple built-in themes. It works locally with no cloud dependencies — all rendering assets are vendored. It accepts single files, folders, ZIP archives, and GitHub URLs as input.

Requirements

marknest requires Chromium for PDF rendering (Mermaid diagrams, math, and HTML-to-PDF conversion). Before running any conversion, ensure Chromium is installed:

# Check if Chromium/Chrome is available
npx playwright install chromium

This only needs to be done once. If the user already has Chrome or Chromium installed on their system, marknest will detect and use it automatically.

Installation

Prefer npx (zero-install):

# Option 1: Use npx (no install needed, recommended)
npx marknest convert ...

# Option 2: Install globally via npm
npm install -g marknest

# Option 3: Install via Cargo (if Rust toolchain is available)
cargo install marknest

Core Commands

Single file conversion

npx marknest convert README.md -o README.pdf

Batch conversion (folder)

npx marknest convert ./docs --all --out-dir ./pdf

From GitHub URL

npx marknest convert https://github.com/user/repo/blob/main/docs/guide.md -o guide.pdf

From ZIP archive

npx marknest convert ./docs.zip --all --out-dir ./pdf

Styling & Themes

marknest has four built-in themes. Choose one that fits the user's needs:

npx marknest convert README.md -o README.pdf --theme github

For custom styling, use --css:

npx marknest convert README.md -o README.pdf --css custom.css

Advanced Features

Table of Contents

npx marknest convert README.md -o README.pdf --toc

Mermaid Diagrams

If the markdown contains Mermaid code blocks, enable rendering:

npx marknest convert README.md -o README.pdf --mermaid auto

LaTeX Math

If the markdown contains LaTeX math expressions:

npx marknest convert README.md -o README.pdf --math auto

Page Layout

# Landscape orientation
npx marknest convert README.md -o README.pdf --landscape

# Custom page size
npx marknest convert README.md -o README.pdf --page-size letter

# Custom margins (pixels)
npx marknest convert README.md -o README.pdf --margin-top 40 --margin-bottom 40

PDF Metadata

npx marknest convert README.md -o README.pdf --title "Project Guide" --author "Team"

Header/Footer Templates

npx marknest convert README.md -o README.pdf --header-template header.html

Validation

Before converting, you can validate markdown files to catch broken links and rendering issues:

npx marknest validate README.md
npx marknest validate ./docs --all --strict

Combining Multiple Options

A typical full-featured conversion command:

npx marknest convert README.md -o README.pdf \
  --theme github \
  --toc \
  --mermaid auto \
  --math auto \
  --title "Project Documentation" \
  --author "Team Name"

Decision Guide

When the user asks to convert markdown to PDF, follow this logic:

1. Identify the input: Single file? Folder? ZIP? GitHub URL?
2. Ask about styling (if not specified): Theme preference? TOC needed?
3. Check for special content: Does the markdown have Mermaid diagrams or LaTeX math? If yes, add --mermaid auto and/or --math auto.
4. Determine output: Single PDF (-o) or batch (--out-dir)?
5. Run the command and verify the output file exists.

If the user has a .marknest.toml config file in their project, marknest will pick it up automatically — no need to pass flags that are already configured there.

Troubleshooting