texmark 0.15.1

Write scientific articles in Markdown and convert them to journal-ready LaTeX/PDF (Copernicus, Science, AMS, AGU, Nature, Elsevier, PNAS, arXiv, ...)

texmark

Write scientific articles in Markdown and convert them to journal-ready LaTeX and PDF.

• Preview while writing. Markdown renders in most editors (VS Code, JetBrains, vim) and on GitHub — equations included — so you can read a draft without running a LaTeX build.
• Lightweight, portable text. Markdown uses much less markup than LaTeX, so the source stays readable and works with ordinary tools: edit it on GitHub, version it with Git (branches, diffs, pull requests), or paste it into a Google Doc to draft interactively with collaborators who prefer that, then bring it back.
• One source, several journal templates. The same Markdown compiles to any of the supported LaTeX templates; changing the target journal means editing one field in the YAML header rather than reformatting the text.
• LaTeX output is kept. The generated .tex sits next to the PDF, so you can stop using texmark at any point and continue in LaTeX directly — usually necessary for the final journal-specific adjustments anyway.

📖 Documentation

Full documentation lives at https://perrette.github.io/texmark/:

• Installation (incl. external dependencies)
• Quickstart
• Journal templates
• YAML reference
• Guides: equations, multi-file projects, custom preamble, encoding, figures, build backends, live preview, custom LaTeX templates

Installation

pip install texmark

texmark also needs pandoc and a LaTeX distribution (pdflatex, bibtex, latexmk). See the installation page for the per-platform details.

Quickstart

See example.md for a sample markdown file with yaml metadata in the header.

texmark example.md          # markdown → tex
texmark example.md --pdf    # markdown → pdf

For another journal, change the journal -> template field in the yaml metadata, or pass -j for a quick test:

texmark example.md --pdf -j science -o build/example-science.pdf --tex build/example-science.tex

See the quickstart and journal templates pages for more.

From the same author

A few other open-source tools I maintain.

Scientific writing & data

• papers — command-line BibTeX bibliography and PDF library manager.
• datamanifest — declarative, reproducible dataset management. (See also the datamanifest.toml format spec and the DataManifest.jl Julia port.)

Speech to Text (dictate) and Text to Speech (read-aloud) tools

• scribe — speech-to-text dictation.
• bard — text-to-speech reader.

Acknowledgements

Parts of this project — notably extending the set of supported journals — were developed with AI assistance.