The Paper Project

Markdown goes in.
PDF comes out.

Paper is the truest form of a document
physical, permanent, and universally readable

report.md

---
title: Quarterly Report
author: Sahu, S
---

# Quarterly Report

## Summary

Revenue grew 12% this quarter,
driven by enterprise adoption.

```mermaid
graph TD
  A[Q1] --> B[Q2]
  B --> C[Q3 ▲12%]
```

## Appendix

See attached figures.

report.pdf

Quarterly Report

Sahu, S

Summary

Revenue grew 12% this quarter, driven by enterprise adoption.

Appendix

See attached figures.

$ paper report.md -o report.pdf

What it handles

diagrams

Mermaid diagrams

Write diagrams as fenced code blocks. They render as crisp graphics in the PDF via headless Chrome.

typography

Emoji rendering

Unicode emoji are converted to SVG images via twemoji so they appear correctly in the printed output.

layout

LaTeX templates

A custom LaTeX template controls headers, page numbers, section breaks, and overall document structure.

Get started

Three commands to install.

# Clone and build

$ git clone https://github.com/mrsauravsahu/paper $HOME/paper

$ cd $HOME/paper && docker build -t paper:latest .

$ ln -sf $HOME/paper/paper $HOME/.local/bin/paper

# Run

$ paper report.md -o report.pdf