mdfusion 0.2.1

Merge Markdown files into a single PDF with Pandoc + XeLaTeX

mdfusion

Merge all Markdown files in a directory tree into a single PDF with formatting via Pandoc + XeLaTeX.

---

Features

• Recursive Markdown merge: Collects and sorts all .md files under a directory (natural sort order).
• PDF output via Pandoc + XeLaTeX: Produces a polished PDF with centered section headings and small margins.
• Title page and metadata: Optional title page with configurable title, author, and date.
• Config file support: Use a mdfusion.toml config file for repeatable builds.
• Custom LaTeX header: Inject your own LaTeX via header.tex if desired.
• Image link rewriting: Converts relative image links to absolute paths, so identically-named images in different folders don't collide.

---

Installation

Install via pip

pip install mdfusion

Install from source

1. Clone this repo
2. Install Python 3.8+ and Pandoc with XeLaTeX support
3. Install the mdfusion package:

pip install ./mdfusion

---

Usage

mdfusion ROOT_DIR [OPTIONS]

Common options

• -o, --output FILE Output PDF filename (default: <root_dir>.pdf)
• --no-toc Omit table of contents
• --title-page Include a title page
• --title TITLE Set title for title page (default: directory name)
• --author AUTHOR Set author for title page (default: OS user)
• --pandoc-args ARGS Extra Pandoc arguments (whitespace-separated)
• -c, --config FILE Path to a mdfusion.toml config file (default: mdfusion.toml in the current directory)

Example

mdfusion --title-page --title "My Book" --author "Jane Doe" docs/

---

Configuration file

You can create a mdfusion.toml file in your project directory:

[mdfusion]
root_dir = docs
output = my-book.pdf
no_toc = true
title_page = true
title = My Book
author = Jane Doe
pandoc_args = --number-sections

Then just run:

mdfusion

---

How it works

• Finds and sorts all Markdown files under the root directory
• Merges them into one file, rewriting image links to absolute paths
• Optionally adds a YAML metadata block for title/author/date
• Inserts page breaks between files
• Calls Pandoc with XeLaTeX and a custom header for formatting

---

Testing

Run all tests with:

pytest

---

Author

ejuet