md2tex - Markdown to LaTeX Converter

md2tex is a powerful, customizable open-source converter that safely translates your standard and GitHub Flavored Markdown (GFM) logic into pure TeX syntax.

Originally built as a simple parser, md2tex has been completely modernized into a robust parsing pipeline powered by an Intermediate Representation (IR) AST structure that guarantees 100% stable parsing without colliding formatting conflicts.

• Strict AST Architecture: Guaranteed reliable markdown block parsing before inline TeX escaping prevents artifacts.
• TUI Dashboard: Native Textual Terminal User Interface for configuration-free execution.
• Full Template Control: Automatically wrap logic in predefined headers, or inject converted contents seamlessly into custom TeX template @@BODYTOKEN@@ blocks.
• GFM Support: Full implicit translation of Tables, Strikethroughs, Code Blocks, Headers, References from standard Markdowns directly into tabular, sout, minted, section, etc.
• Quotes: Native parameter translation into French inline formatting \enquote{} via csquotes.

It is highly recommended to manage implementations via modern package tooling uv.

git clone git@github.com:Malk97sc/md2tex.git
cd md2tex

# We strongly recommend using the interactive TUI
pip install ".[tui]"

git clone git@github.com:Malk97sc/md2tex.git
cd md2tex

# Setup tests and developer linting suites
uv sync

For local PDF compilation of your .tex files, you need pdflatex installed. On Unix systems, you can install TeX Live:

sudo apt update
sudo apt install texlive-latex-extra texlive-fonts-recommended

sudo dnf install texlive-scheme-medium

brew install --cask mactex-no-gui

To use md2tex, we recommend placing your .md files inside the myfiles folder.

Instead of memorizing flags, directly launch a beautiful TUI configuration dashboard:

md2tex tui

# Or
md2tex interactive

The TUI can now convert to .tex and optionally compile to .pdf with pdflatex (2 passes), including an explicit shell-escape toggle.

If you're looking for headless automations or quick CLI overrides:

# General convert (Defaults Article class output to output/<filename>.tex)
md2tex myfiles/document.md
# Or
md2tex path/to/document.md

# Build full encapsulated `.tex` compiling with headers
md2tex path/to/document.md -c

# Advanced custom translation output
md2tex source.md -c -t ./utils/template.tex -o ./export/export.tex -d book -u -f

For a complete understanding of how this tool abstracts parsing structures, as well as TUI capabilities, please review the documentation directory:

• System Architecture Overview
• Terminal User Interface (TUI)
• CLI and TUI Parameters (Step by Step)

Developed by Paul Kervegan in August 2022. Modernized, refactored, and updated with TUI integration by me, Malak in 2026.

Released Open Source under GNU GPL v3.