seamless-pdf 1.0.0

Convert HTML, Markdown, and DOCX documents into continuous, single-page PDFs.

Seamless PDF

Convert HTML, Markdown, and DOCX documents into continuous, single-page PDFs -- no page breaks.

---

Standard PDF converters split your content across fixed-size pages. Seamless PDF renders the entire document onto a single continuous page perfectly sized to the content's width and height. Ideal for long-form reports, documentation snapshots, newsletters and any workflow where page breaks get in the way or you want to retain the original content viewing experience i.e it retains original table of contents.

---

Features

Feature	Description
Single-Page Output	One continuous PDF sized exactly to your content
Multi-Format Input	Supports .html, .md, .markdown, and .docx files
CLI & Python API	Use from the terminal or integrate directly into your code
Markdown Rendering	GitHub-flavored Markdown with syntax highlighting via Pygments
Theme Selection	Render output with light or dark theme via API/CLI
Page Width Control (v1.0.0)	Option to enforce a maximum page width (e.g., 800px)
Custom Margins (v1.0.0)	Added --margin-top, --margin-right, --margin-bottom, and --margin-left arguments
PDF Outlines / Bookmarks (v1.0.0)	Automatically extracts headers (<h1> to <h6>) and maps them into native PDF bookmarks
DOCX Diagnostics	Mammoth conversion warnings/errors are surfaced clearly

---

Installation

pip install seamless-pdf
python -m playwright install chromium
playwright install

Note: Playwright uses a headless Chromium browser under the hood to render documents. The second command downloads the browser binary. For first time installs of playwright or updates you may need download the new browsers with playwright install.

---

Quick Start

Command Line

seamless-pdf input.html -o output.pdf
seamless-pdf README.md -o README.pdf
seamless-pdf report.docx -o report.pdf
seamless-pdf README.md -o README-dark.pdf --theme dark

# Width and Margin control
seamless-pdf README.md -o README-custom.pdf --width 1000px --margin-top 50px --margin-bottom 50px

Python API

from seamless_pdf import convert

convert("input.html", "output.pdf")
convert("README.md", "readme.pdf")
convert("report.docx", "report.pdf")

# Theming, width, and margin overrides
convert(
    "README.md", 
    "readme-custom.pdf", 
    theme="dark", 
    width="1000px", 
    margin_top="50px"
)

---

Usage

The convert function automatically detects the input format from the file extension (.html, .htm, .md, .markdown, .docx). You can also specify the format explicitly:

from seamless_pdf import convert

# Auto-detected as Markdown
convert("docs/notes.md", "notes.pdf")

# Explicit input type override
convert("docs/notes.txt", "notes.pdf", input_type="markdown")

# Optional render theme (light or dark)
convert("docs/notes.md", "notes-dark.pdf", theme="dark")

CLI Options

# Explicit input type override
seamless-pdf docs/notes.txt -o notes.pdf --input-type markdown

# Dark theme rendering
seamless-pdf docs/notes.md -o notes-dark.pdf --theme dark

# Custom page width and margins
seamless-pdf docs/notes.md -o notes.pdf --width 800px --margin-left 20px --margin-right 20px

NOTES on DARKMODE FLAG

Dark mode behavior depends on the input type:

• Markdown / DOCX inputs: Seamless PDF generates HTML and injects the selected theme styles. Using --theme dark (or theme="dark") is expected to produce dark-themed output consistently.
• HTML inputs: Seamless PDF respects the source HTML/CSS and renders it as-is in Chromium with dark color-scheme emulation. If the source HTML is not dark-aware (for example, no dark styles, no prefers-color-scheme rules, or hardcoded light colors), dark output is best effort and cannot be guaranteed.

Practical guidance:

• For guaranteed dark output from HTML, provide HTML that already supports dark mode.
• For light-only HTML, --theme dark remains available but may produce mixed contrast depending on the original styles.

Supported Input Types

Extension	Type Keyword
.html, .htm	html
.md, .markdown	markdown
.docx	docx

---

Requirements

Dependency	Version
Python	3.10, 3.11, 3.12, 3.13
Playwright (Chromium)	>= 1.40.0
markdown	>= 3.10.1
Pygments	>= 2.17.0
pymdown-extensions	>= 10.0
mammoth	>= 1.6.0
pypdf	>= 3.17.0

---

Roadmap

• PDF-to-PDF re-rendering (merge & reflow existing PDFs)
• Broader PDF manipulation toolset

---

What's New in v1.0.0

• Added Page Width Control via the --width CLI argument or API parameter to bound extremely wide documents.
• Added Custom Margins / Padding (--margin-top, --margin-right, --margin-bottom, --margin-left) to let text breathe.
• Added PDF Outlines (Bookmarks). Seamless PDF now automatically parses headers (<h1> to <h6>) and injects them hierarchically into the final continuous PDF!
• Hardened unit tests, stabilized edge cases, and expanded CLI/API configuration consistency.

---

Cloning for your purposes...

git clone https://github.com/SleepyPandas/Document-to-ContinuousPDF.git
cd Document-to-ContinuousPDF
pip install -e ".[dev]"
pytest

---

License

This project is licensed under the MIT License -- see the LICENSE file for details.