R χ \chi iv-Maker: an automated template engine for streamlined scientific publications
Bruno M. Saraiva, Guillaume Jaquemet, Ricardo Henriques · 2025
Read R χ \chi iv-Maker: an automated template engine for streamlined scientific publications by Bruno M. Saraiva, Guillaume Jaquemet, Ricardo Henriques (2025) in the Tower of Babel, a free online library of public-domain works preserved in clean, searchable text. No sign-up. The full text is served as a plain-text file at a predictable URL, where text is present: https://antarctic-labs.com/tower-of-babel/arxiv-2508-00836.txt.
Introduction
Saraiva and co-authors present Rxiv-Maker in 2025, a tool that turns plain text files into polished papers. Preprint culture speeds sharing but loads formatting work onto authors. Computational papers face a worse snag: keeping text in sync with changing data and code.
The engine converts Markdown drafts into publication-ready PDFs and runs embedded code as it builds. Figures and numbers refresh straight from source data, so the output stays current and reproducible. It builds on common tools such as Git and a popular code editor. The workflow borrows software practice for joint writing. The authors aim to cut manual upkeep for fast-moving research teams.
Catalog record
| CREATOR | Bruno M. Saraiva, Guillaume Jaquemet, Ricardo Henriques |
|---|---|
| YEAR | 2025 |
| COLLECTION | PAPERS |
| FORMAT | TXT |
| FILE SIZE | 34 KB |
| VERSION | 1.0 |
| LICENSE | http://creativecommons.org/licenses/by/4.0/ |
| RIGHTS | CC BY |
| SOURCE | arXiv |
Source: https://arxiv.org/abs/2508-00836
Browse the full library · About the Tower of Babel
Full text
The opening of the work, from the library's hosted text:
R χ \chi iv-Maker: an automated template engine for streamlined scientific publications Bruno M. Saraiva, Guillaume Jaquemet, Ricardo Henriques Abstract Preprint servers have become central to research communication, but authors still struggle with manuscript preparation and typesetting. Rxiv-Maker converts Markdown documents to publication-ready PDFs through automated LaTeX processing. Researchers can focus on content while the system handles formatting and typesetting without requiring LaTeX knowledge. The tool supports version control and collaborative editing workflows common in modern research teams. Python and R scripts execute during compilation to generate figures directly from data, keeping visualisations synchronised with analyses. Docker containerisation and automated build systems provide consistent results across different computing environments. Mathematical notation, citations, and cross-references are processed automatically during conversion. This manuscript was prepared using Rxiv-Maker. \leadauthor Saraiva R \chi iv-Maker keywords article template | scientific publishing | preprints {corrauthor} (B. M. Saraiva) bsaraiva and itqb.unl.pt; (G. Jaquemet) guillaume.jacquemet and abo.fi; (R. Henriques) ricardo.henriques and itqb.unl.pt Main Preprint servers like arXiv, bioRxiv, and medRxiv have become central to research communication ( 1 , 2 , 3 ) . As submission rates climb (Fig. 0.0.6 , Fig. 0.0.6 ), researchers now handle tasks once managed by journal production teams ( 4 , 5 ) . Most manuscript preparation workflows use proprietary formats that work poorly with version control systems, making collaborative research more difficult ( 6 ) . Computational research faces particular challenges because algorithms, analysis methods, and processing pipelines change frequently. In computational biology, researchers struggle to keep manuscripts synchronized with evolving analysis code, leading to publications that don’t accurately describe the methods used. Bioimage analysis shows these problems clearly: collaborative frameworks ( 7 ) and containerised analysis environments ( 8 ) highlight how important reproducible computational workflows are for scientific publishing. Rxiv-Maker helps address these challenges by providing a developer-centric framework for reproducible preprint preparation. It generates publication-standard PDFs through automated LaTeX processing and works directly with Git workflows and continuous integration practices. Built-in reproducibility features ensure manuscripts build consistently across different systems and over time. Manuscript preparation becomes a transparent process that gives researchers access to professional typesetting tools. A Visual Studio Code extension provides syntax highlighting and automated citation management. Researchers can leverage familiar development environments while maintaining rigorous version control and reproducibility guarantees. This bridges traditional authoring workflows with contemporary best practices in computational research. Figure 1: The Rxiv-Maker System Diagram. The system integrates Markdown content, YAML metadata, Python and R scripts, and bibliography files through a processing engine. This engine leverages GitHub Actions, virtual environments, and LaTeX to produce a publication-ready scientific article, demonstrating a fully automated and reproducible pipeline. Figure 2: Rxiv-Maker Workflow: User Input vs. Automated Processing. The framework clearly separates user responsibilities (content creation and configuration) from automated processes (parsing, conversion, compilation, and output generation). Users only need to write content and set preferences. At the same time, the system handles all technical aspects of manuscript preparation automatically, ensuring a streamlined workflow from markdown input to publication-ready PDF output. The framework enables programmatic generation of figures and tables using Python and R scripting with visualisation libraries including Matplotlib ( 9 ) and Seaborn ( 10 ) . Figures can be generated directly from source datasets during compilation, establishing transparent connections between raw data, processing pipelines, and final visualisations. This executable manuscript approach eliminates the manual copy-and-paste workflow that traditionally introduces errors when transferring results between analysis and documentation ( 11 ) . When datasets are updated or algorithms refined, affected figures are automatically regenerated, ensuring consistency and eliminating outdated visualisations. The system integrates Mermaid.js ( 12 ) for generating technical diagrams from text-based syntax, with the complete range of supported methods detailed in Table 0.0.6 . This approach reframes manuscripts as executable outputs of the research process rather than static documentation. Built upon the HenriquesLab bioRxiv template ( 13 ) , Rxiv-Maker extends capabilities through automated processing pipelines. The architecture, detailed in Fig. 1 and Fig. 2 , provides automated build processes through GitHub Actions and virtual environments, with technical details described in 0.0.6 . Academic authors use various tools depending on their research needs and technical requirements. Traditional LaTeX environments like Overleaf democratise professional typesetting through accessible web interfaces, but struggle with version control and computational content integration. Multi-format publishing platforms including Quarto, R Markdown, and Bookdown excel at producing multiple output formats with statistical integration, though they introduce complexity for simple documents and variable LaTeX typesetting quality. Collaborative writing frameworks such as Manubot enable transparent, version-controlled scholarly communication with automated citation management ( 14 ) , yet offer limited computational reproducibility features. Web-first computational systems like MyST and Jupyter Book prioritise interactive content and browser-native experiences, but compromise PDF output quality and offline accessibility. Modern typesetting engines like Typst provide cleaner syntax and faster compilation, though ecosystem maturity and adoption remain barriers. Rxiv-Maker occupies a specialised niche at the intersection of developer workflows, academic publishing, and computational reproducibility. This developer-centric approach requires technical setup but delivers automated, reproducible PDF preprint generation particularly suited to computational research where datasets evolve and algorithmic documentation is essential. The framework trades initial complexity for long-term automation benefits, enabling deeper specialisation for manuscripts involving dynamic content and processing pipelines. A comprehensive comparison is provided in Table 0.0.6 . Rxiv-Maker simplifies manuscript creation by building reproducibility directly into the writing process. Writers work in familiar Markdown, which the system converts to LaTeX and compiles into publication-ready PDFs with proper formatting, pagination, and high-quality figures. Docker containerisation addresses computational reproducibility by encapsulating the complete environment (LaTeX distributions, Python libraries, R packages, and system dependencies) within immutable container images. GitHub Actions workflows leverage pre-compiled Docker images for standardised compilation processes, reducing build times from 8-10 minutes to approximately 2 minutes. The Docker engine mode enables researchers to generate PDFs with only Docker and python as prerequisites. This is valuable for collaborative research across platforms or institutional settings with software restrictions ( 15 ) . The system automatically saves all generated files, creating a complete record from source materials to the finished document. For users who want immediate feedback, we provide Google Colab notebook deployment that compiles documents in real-time while preserving reproducibility. We’ve also developed a Docker-based version using udocker ( 16 ) that cuts setup time dramatically (from about 20 minutes down to 4 minutes). It runs in pre-configured containers with all dependencies already installed, eliminating manual setup and ensuring consistency between Colab sessions. Available deployment strategies are compared in Table 0.0.6 . When working with figures, the system handles both static images and dynamic content. Drop Python or R scripts into designated folders, and Rxiv-Maker will execute them during compilation, pulling in data, running analyses, and generating visualisations that appear in the final PDF ( 17 ) . It even renders Mermaid.js diagrams from markdown into crisp SVG images. This approach makes manuscripts complete, verifiable records of research where readers can trace every figure and result back to its source code and data. The Visual Studio Code extension provides editing features including real-time syntax highlighting, autocompletion for bibliographic citations from BibTeX files, and cross-reference management. The extension reduces cognitive load and minimises syntax errors while maintaining consistent formatting. Rxiv-Maker combines plain-text authoring with automated build environments to