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.
1 maintainer
Metadata
1 maintainer
Release files for rxiv-maker 1.25.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| rxiv_maker-1.25.0.tar.gz | 1.8 MB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| rxiv_maker-1.25.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 2.4 MB
Release files / rxiv_maker-1.25.0.tar.gz
| Download URL | rxiv_maker-1.25.0.tar.gz |
|---|---|
| Size | 1.8 MB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
75fe2f5d5f0e43cb4f83f19414bbfd6485d6b5fcc913b43b17f74180e163fb80
|
|
BLAKE2b-256 checksum How to use checksums |
ff22a5e04b984301eb64e1fc111b1786a91d62d7427f320db462ea076a1ea0af
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.11.16
|
Release files / rxiv_maker-1.25.0-py3-none-any.whl
| Download URL | rxiv_maker-1.25.0-py3-none-any.whl |
|---|---|
| Size | 629.8 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
ee302a2265ed546e7631b892a61f7e212e62409312dd7334f51fd09144ab8251
|
|
BLAKE2b-256 checksum How to use checksums |
cfdf72a400b8843a6f6eb065cc0cebd1afc9a07cff5d6c10eef6eeecb7255c0a
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.11.16
|
