DOI License GitHub stars

Rxiv-Maker

Rxiv-Maker converts enhanced Markdown into professional PDFs with automated figure generation, citation management, and LaTeX typesetting. Write in Markdown, get publication-ready output for arXiv, bioRxiv, and other preprint servers.

Installation

macOS (includes LaTeX automatically):

brew install henriqueslab/formulas/rxiv-maker

Linux / Windows (WSL):

pipx install rxiv-maker    # or: uv tool install rxiv-maker

Verify setup:

rxiv check-installation

LaTeX is required. See the installation guide for platform-specific LaTeX instructions.

Quick Start

rxiv init my-paper
cd my-paper
rxiv pdf

To explore a complete working example:

rxiv get-rxiv-preprint
cd manuscript-rxiv-maker/MANUSCRIPT
rxiv pdf

Features

  • Enhanced Markdown - Scientific cross-references (@fig:plot, @eq:formula), auto-numbered figures/tables/equations, LaTeX math
  • Automated figures - Python and R scripts executed during PDF generation, with intelligent caching
  • Executable code blocks - Jupyter-like {{py:exec}} and {{py:get variable}} for live data in manuscripts
  • Citation management - BibTeX with [@citation] syntax, multiple styles, inline DOI resolution
  • Dual output - PDF and DOCX from the same source
  • arXiv/bioRxiv submission - Generate submission packages automatically
  • Track changes - Visual diff between manuscript versions
  • VS Code extension - Syntax highlighting, citation autocompletion, one-click builds

Documentation

rxiv-maker.henriqueslab.org - Installation, guides, CLI reference, troubleshooting.

For contributors: CONTRIBUTING.md

Ecosystem

Repository Purpose
rxiv-maker Core CLI tool
docker-rxiv-maker Pre-configured container with LaTeX
manuscript-rxiv-maker Complete example (arXiv:2508.00836)
vscode-rxiv-maker VS Code extension

Publications

Preprints and papers written with Rxiv-Maker are collected on the Publications Showcase, which also links a live Google Scholar search for new work. Using it for your research? Let us know.

Community

Citation

@misc{saraiva_2025_rxivmaker,
  title={Rxiv-Maker: an automated template engine for streamlined scientific publications},
  author={Bruno M. Saraiva and Rita Carlota and Ant\'{o}nio D. Brito and Iván Hidalgo-Cenalmor and Guillaume Jacquemet and Ricardo Henriques},
  year={2025},
  eprint={2508.00836},
  archivePrefix={arXiv},
  url={https://arxiv.org/abs/2508.00836}
}

License

MIT License - see LICENSE for details.

Project links

Data verified by PyPI on Jul 13, 2026
Data provided by the project maintainers, verified at the time the release was uploaded to PyPI.

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Newer release available (1.23.3)

1 maintainer

PyPI data
Data sourced directly from PyPI's database.
Avatar for ricardo_henriques from gravatar.com ricardo_henriques

Credits

Author: Rxiv-Maker Contributors

GitHub Statistics

Data verified by PyPI on Jul 13, 2026
The GitHub source repository was provided by the project maintainers and verified by PyPI at the time of upload. Stars, forks, and open issues/PRs are derived from that repository and have not been independently verified.

License

MIT License

Requires

Python >=3.10

Provides Extra

dev

Tags

automation cli command-line hatch latex markdown publishing scientific-writing

Classifiers

Report project as malware

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

rxiv_maker-1.22.2.tar.gz (1.8 MB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

rxiv_maker-1.22.2-py3-none-any.whl (615.0 kB view details)

Uploaded Python 3

File details

Details for the file rxiv_maker-1.22.2.tar.gz.

File metadata

  • Download URL: rxiv_maker-1.22.2.tar.gz
  • Upload date:
  • Size: 1.8 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.2.0 CPython/3.11.15

File hashes

Hashes for rxiv_maker-1.22.2.tar.gz
Algorithm Hash digest
SHA256 ac6f1d9ddb043804d7a3a18d44a4f4a9bf93f66bd72ea23163c2d1a61cae1957
MD5 e8d1bc94821b3465396894674a7a9027
BLAKE2b-256 c636ffd7a2da7e349391e526c6122540d1d35ea0ec061203504b3bd02cd35834

See more details on using hashes here.

File details

Details for the file rxiv_maker-1.22.2-py3-none-any.whl.

File metadata

  • Download URL: rxiv_maker-1.22.2-py3-none-any.whl
  • Upload date:
  • Size: 615.0 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.2.0 CPython/3.11.15

File hashes

Hashes for rxiv_maker-1.22.2-py3-none-any.whl
Algorithm Hash digest
SHA256 ac0588a10adf667af2f5c081910e530c418cda019ef8f4cb040f6f650c126514
MD5 030fc59470b86bb5f1558fd37b8723b6
BLAKE2b-256 b55d1a0806c8d49ff5e74e7bd8fc1f0c8b6d65d19a21d496dcb905d4d3e3ce9d

See more details on using hashes here.

Release history Release notifications | RSS feed

1.23.3

1.23.2

1.23.1

1.23.0

1.22.4

1.22.3

This release

1.22.2

1.22.1

1.22.0

1.21.0

1.20.4

1.20.3

1.20.2

1.20.1

1.20.0

1.19.2

1.19.1

1.19.0

1.18.5

1.18.4

1.18.3

1.18.2

1.18.1

1.18.0

1.17.0

1.16.8

1.16.7

1.16.6

1.16.5

1.16.4

1.16.3

1.16.2

1.16.1

1.16.0

1.15.9

1.15.8

1.15.7

1.15.6

1.15.5

1.15.4

1.15.3

1.15.2

1.15.1

1.15.0

1.14.3

1.14.2

1.14.1

1.14.0

1.13.7

1.13.6

1.13.5

1.13.4

1.13.3

1.13.2

1.13.1

1.13.0

1.12.2

1.12.1

1.12.0

1.11.3

1.11.2

1.11.1

1.11.0

1.10.0

1.9.4

1.9.3

1.9.2

1.9.1

1.9.0

1.8.9

1.8.8

1.8.7

1.8.6

1.8.4

1.8.3

1.8.0

1.7.9

1.7.8

1.7.4

1.7.3

1.7.2

1.7.1

1.6.4

1.6.3

1.6.1

1.6.0

1.5.26

1.5.25

1.5.24

1.5.23

1.5.22

1.5.21

1.5.20

1.5.19

1.5.18

1.5.17

1.5.16

1.5.15

1.5.14

1.5.13

1.5.12

1.5.10

1.5.8

1.5.7

1.5.5

1.5.4

1.5.2

1.4.25

1.4.24

1.4.21

1.4.20

1.4.19

1.4.18

1.4.17

1.4.15

1.4.11

1.4.8

1.4.6

1.4.5

1.4.4

1.4.0

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page