Abstract:The timely publication of scientific results is essential for dynamic advances in science. The ubiquitous availability of computers which are connected to a global network made the rapid and low-cost distribution of information through electronic channels possible. New concepts, such as Open Access publishing and preprint servers are currently changing the traditional print media business towards a community-driven peer production. However, the cost of scientific literature generation, which is either charged to readers, authors or sponsors, is still high. The main active participants in the authoring and evaluation of scientific manuscripts are volunteers, and the cost for online publishing infrastructure is close to negligible. A major time and cost factor is the formatting of manuscripts in the production stage. In this article we demonstrate the feasibility of writing scientific manuscripts in plain markdown (MD) text files, which can be easily converted into common publication formats, such as PDF, HTML or EPUB, using pandoc. The simple syntax of markdown assures the long-term readability of raw files and the development of software and workflows. We show the implementation of typical elements of scientific manuscripts – formulas, tables, code blocks and citations – and present tools for editing, collaborative writing and version control. We give an example on how to prepare a manuscript with distinct output formats, a DOCX file for submission to a journal, and a LATEX/PDF version for deposition as a PeerJ preprint. Further, we implemented new features for supporting ‘semantic web’ applications, such as the ‘journal article tag suite’ - JATS, and the ‘citation typing ontology’ - CiTO standard. Reducing the work spent on manuscript formatting translates directly to time and cost savings for writers, publishers, readers and sponsors. Therefore, the adoption of the MD format contributes to the agile production of open science literature. Pandoc Scholar is freely available from https://github.com/pandoc-scholar .

A reproducible manuscript workflow with a Quarto template

Formatting Open Science: agilely creating multiple document formats for academic manuscripts with Pandoc Scholar

Reproducible manuscript preparation with RMarkdown application to JMSACL and other Elsevier Journals

You Only Write Thrice: Creating Documents, Computational Notebooks and Presentations From a Single Source

Writing a reproducible paper with R Markdown and Pagedown

Large-Scale Collaborative Writing: Technical Challenges and Recommendations

Let's Write a Manuscript: A Primer With Tips and Tricks for Penning an Original Article

Saving time and money in biomedical publishing: the case for free-format submissions with minimal requirements

R Markdown: The Definitive Guide

A Collaborative Approach to Computational Reproducibility

ReproduceMe: Lessons from a pilot project on computational reproducibility

On the Programmatic Generation of Reproducible Documents

Tips and tricks for writing a manuscript to publish in a biomedical journal

LiveDocs: Crafting Interactive Development Environments From Research Findings

PharmTeX: a LaTeX-Based Open-Source Platform for Automated Reporting Workflow

rworkflows: automating reproducible practices for the R community

Process for selecting and implementing a manuscript management system: Experiences of a new peer‐reviewed journal

The FAIRification of research in real‐world evidence: A practical introduction to reproducible analytic workflows using Git and R

Primer on Reproducible Research in R: Enhancing Transparency and Scientific Rigor

Community Workflows to Advance Reproducibility in Hydrologic Modeling: Separating model‐agnostic and model‐specific configuration steps in applications of large‐domain hydrologic models

Resequencing: A Method for Conforming to Conventions for Sharing Credits Among Multiple Authors