Markdown-zu-LaTeX-Konverter (md2tex)
Konvertiert akademische Markdown-Manuskripte in LaTeX-.tex-Dateien, die für die Einreichung bei Fachzeitschriften geeignet sind. Deckt die gesamte Konvertierungspipeline ab: Überschriften, fett/kursiv, Pipe-Tabellen, Bilder, angezeigte/Inline-Mathematik, Aufzählungslisten, Unicode-Sonderzeichen und Zitierformatierung.
Kurzstart
# Einfach: einzelne .md in Article-Klasse .tex konvertieren
python3 scripts/md2tex.py paper.md -o output/
# Dokumentklassen-Vorlage wählen
python3 scripts/md2tex.py paper.md -o output/ --class ieeetran
python3 scripts/md2tex.py paper.md -o output/ --class revtex
# Mehrere Dateien: Hauptmanuskript + Anhang als Ergänzungsmaterial
python3 scripts/md2tex.py main.md --appendix appendix.md -o output/ --class revtex
# Benutzerdefinierte Präambel-Überschreibungen (Pakete, Befehle usw. hinzufügen)
python3 scripts/md2tex.py paper.md --preamble my_preamble.tex -o output/
# PDFs nach der Generierung kompilieren
python3 scripts/md2tex.py paper.md -o output/ --compile
Pfade oben sind relativ zum Basisverzeichnis dieser Skill.
Was es tut
Das Skript liest Markdown und erzeugt LaTeX, indem es diese Konvertierungen anwendet:
| Markdown | LaTeX |
|---|---|
## Abschnitt | \section{Abschnitt} |
### Unterabschnitt | \subsection{Unterabschnitt} |
#### Unterunterabschnitt | \subsubsection{Unterunterabschnitt} |
**fett** | \textbf{fett} |
*kursiv* | \textit{kursiv} (mathematikbewusst: überspringt $...$) |
$$...$$ | $$...$$ (Durchleitung) |
$...$ | $...$ (Durchleitung) |
| ... | Pipe-Tabellen | \begin{tabular}...\end{tabular} |
 | \begin{figure}\includegraphics...\caption...\end{figure} |
![[pfad|alt]] (Obsidian) | Wie oben |
- Aufzählungspunkt | \begin{itemize}\item...\end{itemize} |
α, β, ∞, →, × usw. | $\alpha$, $\beta$, $\infty$, $\to$, $\times$ |
--- (Gedankenstrich) | --- (beibehalten) |
Zusätzliche Verarbeitung
- Bildunterschriften: Sucht voraus nach Zeilen wie
**Abb. N | ...**oder**Abb. N.**nach Bildern, um korrekte\caption{...}zu erstellen. - Tabellenunterschriften: Sucht nach Blöcken wie
**Tabelle N | ...**oder**TABELLE N**vor Pipe-Tabellen. - Unicode-Mathematik: Bildet
α β γ ε λ μ π ρ σ ω Γ Λ Σ Ω ∞ → ← × ± ≤ ≥ ≈ ≠ ¬auf LaTeX-Äquivalente ab. - Akzentuierte Zeichen: Bildet
é è ê ñ ö ü â î ôauf LaTeX-Escape-Sequenzen ab. - Geschickte Anführungszeichen:
"" ''zu`` ''. - Polnisches
ł:Białynicki→Bia{\l}ynickifür korrekte Darstellung. - Leerzeilenbereinigung: Reduziert 4+ Leerzeilen auf 2.
- Blockzitatentfernung: Entfernt optional Zeilen mit
> ....
Dokumentklassen-Vorlagen
| Vorlage | Dokumentklasse | Verwendungszweck |
|---|---|---|
article (Standard) | \documentclass[12pt]{article} | Allgemeine Arbeiten, arXiv |
revtex | \documentclass[aps,pra,preprint]{revtex4-2} | Physical Review Journals |
ieeetran | \documentclass[journal,onecolumn,12pt]{IEEEtran} | IEEE Transactions |
Jede Vorlage enthält geeignete Pakete (graphicx, amsmath, amssymb, hyperref, booktabs, array).
Benutzerdefinierte Präambel
Erstellen Sie eine .tex-Datei mit Ihrer vollständigen Präambel (Pakete, Befehle usw.) und übergeben Sie sie mit --preamble. Die Standardeinstellung für jede Vorlage wird überschrieben.
Beispiel my_preamble.tex:
\documentclass[aps,pra,reprint]{revtex4-2}
\usepackage{graphicx}
\usepackage{amsmath,amssymb}
\usepackage{hyperref}
\usepackage{booktabs}
\usepackage{xcolor}
\newcommand{\pbox}[2]{\parbox{#1}{\vspace{4pt}\RaggedRight #2\vspace{4pt}}}
Zitierbehandlung
Zwei Modi, einstellbar mit --cite:
bibtex (Standard)
Behält BibTeX-Schlüssel im Text: \cite{key2020}. Standardmäßig werden Zitierschlüssel aus einem Referenzabschnitt oder einer Bibliotheksdatei gelesen. Platzhalter im Stil [N] bleiben unverändert, es sei denn, --cite-map wird angegeben.
inline
Bettet \begin{thebibliography}...\end{thebibliography} mit handschriftlichen Einträgen ein. Verwenden Sie --biblio references.tex, um den Bibliotheksinhalt bereitzustellen.
Erweiterte Optionen
--title "Titel der Arbeit" Überschreibt den Dokumenttitel (Standard: erste #-Überschrift)
--author "Name" Autorenname
--affiliation "Uni" Autorenzugehörigkeit
--email "[email protected]" Korrespondenz-E-Mail
--abstract Extrahiert Abstract aus Abschnitt ## Zusammenfassung (Standard: automatisch)
--no-abstract Überspringt die Abstract-Extraktion
--appendix appendix.md Konvertiert Anhang als Ergänzungsmaterial
--suppress-numbers Verwendet \section*{} (unnummeriert, für Ergänzungsmaterial)
--cite-map map.json JSON-Zuordnung von Zitierplatzhaltern zu BibTeX-Schlüsseln
--compile Führt pdflatex zweimal nach der Generierung aus
--fig-dir figures/ Verzeichnis zum Kopieren der Abbildungen (Standard: automatische Erkennung)
--help Zeigt die vollständige Nutzung an
Kompilierungshinweise
Nach der Generierung von .tex-Dateien mit folgendem Befehl kompilieren:
# REVTeX (erfordert installierte revtex4-2.cls)
cd output/ && pdflatex main.tex && pdflatex main.tex
# IEEEtran (erfordert installierte IEEEtran.cls)
cd output/ && pdflatex main.tex && pdflatex main.tex
Das Skript erkennt automatisch Abbildungen, auf die im Markdown verwiesen wird, und kopiert sie aus dem Quellverzeichnis in das Ausgabeverzeichnis.
Einschränkungen
- Kein universeller Konverter: Entwickelt für die akademische Papierstruktur (IMRaD + Ergänzungsmaterial). Komplexe verschachtelte Listen, Codeblöcke und Fußnoten erfordern möglicherweise manuelle Anpassungen.
- Nur Pipe-Tabellen: HTML-
<table>-Tags werden nicht konvertiert. - Einzeilige Aufzählungspunkte: Behandelt derzeit 2-stufige Verschachtelung; tiefere Listen werden möglicherweise abgeflacht.
- Mathematik-Umgebungen:
\begin{aligned}...\end{aligned}usw. werden unverändert durchgelassen – stellen Sie sicher, dass sie gültiges LaTeX sind. - Zitierkonvertierung:
[N]zu\cite{}erfordert eine vom Benutzer bereitgestellte Zuordnungsdatei oder manuelle Nachbearbeitung. - Kein Live-Neuladen:
.texnach jeder.md-Änderung neu generieren; die Skill überwacht keine Dateien.
Verwenden Sie für die PDF-Wiedergabe im Obsidian-Stil (A4, Arial, MathJax) stattdessen die obsidian-pdf-Skill.