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 and official paper (JCS doi:10.1242/jcs.265183, 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

GitHub Discussions - Questions and tips
Issues - Bug reports and feature requests
Google Colab - Try without installing

Citation

@article{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},
  journal={Journal of Cell Science},
  year={2026},
  doi={10.1242/jcs.265183},
  url={https://doi.org/10.1242/jcs.265183}
}

License

MIT License - see LICENSE for details.

Metadata

Release files for rxiv-maker 1.25.3

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for rxiv-maker 1.25.3
File	Size	Uploaded
rxiv_maker-1.25.3.tar.gz	1.8 MB	Oct 15, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for rxiv-maker 1.25.3
File	Interpreter	ABI	Platform	Reset
rxiv_maker-1.25.3-py3-none-any.whl 634.7 kB Oct 15, 2026	Python 3	none	any	Details

Total release size: 2.4 MB

Release files / rxiv_maker-1.25.3.tar.gz

Download URL	rxiv_maker-1.25.3.tar.gz
Size	1.8 MB
Tags	Source
SHA-256 checksum How to use checksums	`d2c418866bca5afa596632847c952aad273f4c6a25e6d8168a53afae9ef3aae8`
BLAKE2b-256 checksum How to use checksums	`6afb3001d940692bc9283be8942a150fd57b93f00f0b8b60b39f73e7c005fdfa`
Upload date	Oct 15, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/7.0.0 CPython/3.11.17`

Release files / rxiv_maker-1.25.3-py3-none-any.whl

Download URL	rxiv_maker-1.25.3-py3-none-any.whl
Size	634.7 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`7955a1434dca3427b62708e969dd6c7cb4e686475dffddc27c9db55ed6337bc5`
BLAKE2b-256 checksum How to use checksums	`fd090483dfa4de548505a99e71cc0a159bb5735c31ac951a31159f7756f86276`
Upload date	Oct 15, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/7.0.0 CPython/3.11.17`