Write scientific preprints in Markdown. Generate publication-ready PDFs efficiently.
Project description
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
Using Rxiv-Maker for your research? Let us know.
Community
- GitHub Discussions - Questions and tips
- Issues - Bug reports and feature requests
- Google Colab - Try without installing
Citation
@misc{saraiva_2025_rxivmaker,
title={Rxiv-Maker: an automated template engine for streamlined scientific publications},
author={Bruno M. Saraiva and Ant\'{o}nio D. Brito and Guillaume Jaquemet 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 details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file rxiv_maker-1.20.3.tar.gz.
File metadata
- Download URL: rxiv_maker-1.20.3.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
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
47e795527d844f9aeffec18a207a19119c0d1386fd56f5c3d42415cb14954ee5
|
|
| MD5 |
95aab8123541655e13b3d3c2c253be70
|
|
| BLAKE2b-256 |
07f0ff3bde884720f337fb956ae3d3db3320b10e8612d79e7fd0ab29d7387899
|
File details
Details for the file rxiv_maker-1.20.3-py3-none-any.whl.
File metadata
- Download URL: rxiv_maker-1.20.3-py3-none-any.whl
- Upload date:
- Size: 607.4 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/6.2.0 CPython/3.11.15
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
d02ef8f60535f779e8bcf8d30d2d64300fd2b4ba1b5d1a25a79c6dab1a203dc0
|
|
| MD5 |
2ccd60ee7f0f3bb53382424347f3d2b7
|
|
| BLAKE2b-256 |
8ac6781e1fe92fb533630033f15d5adbd4239715ca067745d9e30e324ea495f9
|