Export: LaTeX-PDF des Lebenslaufs¶
Für Fortgeschrittene (Operator-Inhalt)
Diese Seite richtet sich an die Person, die den Export ausführt: Sie nennt Pakete,
Kommandozeilen und einen Container. Willst du nur eine PDF eines geprüften Dokuments, bitte
den Export-Skill darum (/claude-job-search:job-application-export) und komm hierher zurück,
wenn er ein fehlendes Werkzeug meldet.
Diese Seite beschreibt, was benötigt wird, um einen fertigen Lebenslauf mit dem LaTeX-Template in eine PDF umzuwandeln, und welche Befehle das ausführen. Einzige Eingabe ist die Markdown-Quelle. PDF und LaTeX-Quelle entstehen daraus.
Welches Format für welchen Empfänger
Eine Text-PDF ist der Standard, auch für Bewerbungsportale (ATS): Das Layout ist einspaltig ohne Tabellen, was Parser im Allgemeinen der Reihe nach lesen. Das ist eine Layout-Regel und eine Prüfung des ausgelesenen Textes (siehe „Was der Export prüft“), keine Aussage über ein bestimmtes ATS. DOCX erzeugst du nur, wenn ein Portal es ausdrücklich verlangt. HTML und Markdown dienen der Ansicht und deinen eigenen Unterlagen.
Was benötigt wird¶
| Werkzeug | Wofür | Typisches Paket (Debian / Ubuntu) |
|---|---|---|
| pandoc | Markdown nach LaTeX, DOCX, HTML | pandoc |
| LuaLaTeX | Kompilieren der PDF aus der LaTeX-Quelle | texlive-luatex |
| Deutsche Sprachunterstützung für LaTeX | babel mit ngerman im Template |
texlive-lang-german |
| Schriften für LuaLaTeX | Das Template nutzt Lato und fällt ohne Lato auf Latin Modern Sans zurück | fonts-lato, texlive-fonts-recommended |
| poppler-utils | pdfinfo und pdftotext für Seitenprüfung und Textprüfung |
poppler-utils |
| python-docx | Nur für DOCX, nicht für PDF | pip install python-docx |
Die Tabelle nennt typische Paketnamen. Sie sind nicht auf jedem System geprüft. Das Ergebnis
prüfst du mit pdfinfo und mit der Inhaltsprüfung des Exports.
Für die LaTeX-Quelle allein (--format tex) reicht pandoc. LuaLaTeX ist dafür nicht nötig.
Layout¶
Die PDF ist einspaltig und nutzt eine Akzentfarbe (dunkles Blau), dünne Linien unter den Abschnittsüberschriften und farbige Aufzählungspunkte. Es gibt keine Tabellen, Symbole, Fotos oder Text in Kopf- und Fußzeile außer einer dezenten Seitenzahl, ein Parser liest also denselben Text wie die Markdown-Quelle.
- Kopfbereich: Der Name steht zuerst und groß, darunter die persönlichen Angaben.
- Stationen: Der Zeitraum steht in einer linken Spalte, die Position fett, Arbeitgeber und Ort darunter in Grau. Ausbildung und Zertifikate nutzen dieselbe Spalte für ihre Zeiträume.
- Typografie: Lato in 10,5 pt auf 14,3 pt Zeilenabstand, Flattersatz, wenig Silbentrennung, Produktnamen wie
VMware Tanzubrechen nicht um. Die Schrift wird nicht verkleinert, um zwei Seiten zu erreichen. - Druck und Bildschirm: Die Farben behalten ihren Kontrast auf Weiß (Text 15,8:1, Akzent 8,7:1, Grau 6,1:1), und die Hierarchie bleibt in Graustufen sichtbar.
- Brief: Das Anschreiben nutzt dasselbe Template mit eigenen Rändern (25 mm links).
Das Design steht in skills/job-application-export/templates/ (document.tex und cv.lua).
Exit-Codes¶
| Code | Bedeutung |
|---|---|
0 |
Export fertig |
1 |
Fehler, zum Beispiel email mit einem anderen Format als md |
2 |
Der Inhalt des Exports weicht von der Quelle ab; die Datei bleibt, ist aber nicht versandbereit |
3 |
--reproduce: abweichende Ausgabe oder geänderte Quelle |
4 |
Seitenlimit des Dokumenttyps überschritten; Datei und Manifest bleiben erhalten. Ein Lebenslauf mit format: einseitig hat das Limit einer Seite. Den Schweregrad setzt die Qualitätsprüfung |
Die Umgebungsvariablen PLUGIN_REVISION und EXPORT_IMAGE_ID stehen im Manifest unter umgebung.
Für Entwickler
Die Layoutregeln stehen in spec/job-application/lebenslauf/en.md (LB-11), die ATS-Regel in
spec/job-application/konventionen/en.md (R-8.3, R-10).
Eingabe¶
Die Quelle ist eine Markdown-Datei eines Bewerbungsordners oder eines Ausprägungsordners:
job-application/<slug>/lebenslauf.md der Lebenslauf einer Bewerbung
job-application/lebenslauf-basis/lebenslauf.md der Arbeitsstand einer Ausprägung
job-application/lebenslauf-basis/versionen/v001_2026-10-22.md eine eingefrorene Version dieser Ausprägung
Der Export prüft die Seitenzahl gegen den Dokumenttyp. Ein Lebenslauf darf höchstens zwei Seiten haben.
Eine eingefrorene Version exportieren. Die Kopie, die du versendest, sollte aus einer
eingefrorenen Version stammen, nicht aus dem Arbeitsstand, damit sie sich später nachbauen lässt.
Gib dem Export die Datei in versionen/; die Ausgabe landet in export/ desselben
Ausprägungsordners und heißt nach der Version (v001_2026-10-22.pdf), nicht nach dem Tag des
Exports. Für die Kopie an den Empfänger nutzt du --name Vorname_Nachname_Lebenslauf.
Befehle¶
Führe sie im Hauptverzeichnis des Plugin-Repositorys aus, dort liegt die Taskfile.yml:
task export -- job-application/<slug>/lebenslauf.md --format pdf --doc-type cv
task export -- job-application/<slug>/lebenslauf.md --format pdf --doc-type cv --name Vorname_Nachname_Lebenslauf
task export -- job-application/<slug>/lebenslauf.md --format tex --doc-type cv
| Option | Bedeutung |
|---|---|
--format pdf |
PDF, kompiliert mit LuaLaTeX |
--format tex |
Nur die LaTeX-Quelle, ohne Kompilieren |
--format docx |
Word-Dokument, braucht python-docx |
--format html oder md |
HTML- oder Markdown-Kopie |
--doc-type cv |
Lebenslauf, höchstens zwei Seiten |
--doc-type letter |
Anschreiben, eine Seite |
--doc-type motivation |
Motivationsschreiben, eine Seite für die Stellenvarianten, zwei Seiten bei studium und stipendium (Frontmatter-Schlüssel variante) |
--doc-type email |
E-Mail-Text, nur mit --format md |
--name |
Dateiname ohne Endung, Standard ist der Name der Quelle |
--out-dir |
Ausgabeordner, Standard export/ neben der Quelle: job-application/<slug>/export/ bei einer Bewerbung, job-application/<ausprägung>/export/ bei einer Ausprägung oder einer ihrer eingefrorenen Versionen |
Ergebnisse¶
Im Ausgabeordner entstehen:
- die PDF (
<name>.pdf) und bei--format pdfdie LaTeX-Quelle (<name>.tex). Die Hilfsdateien von LuaLaTeX werden gelöscht. - Seitenzahl und Ergebnis der Inhaltsprüfung auf der Konsole. Eine fehlgeschlagene Inhaltsprüfung wird gemeldet, und der Export gilt dann nicht als fertig.
- ein Manifest (
<name>.<ext>.manifest.json): Hash von Quelle, Vorlage und Ausgabe, Werkzeugversionen, das verwendete Datum und unterpruefungdas Ergebnis der Prüfungen dieses Laufs (unten).
Was der Export prüft¶
Ein gelungener Export ist kein richtiger Lebenslauf und keine ATS-Garantie
Die Prüfungen vergleichen die ausgegebene Datei mit ihrer Markdown-Quelle. Sie vergleichen sie nicht mit deiner
Datengrundlage (das macht cv_checks.py im Quality Gate), und keine Prüfung bezieht ein Bewerbermanagementsystem
ein. Ein Manifest entsteht auch bei einer fehlgeschlagenen Prüfung; es hält fest, was geprüft wurde, und
bescheinigt den Lebenslauf nicht.
| Frage | Prüfung | Ergebnis |
|---|---|---|
| Wurde die Datei erzeugt? | Exit-Code der Werkzeuge, Datei geschrieben, Seitenzahl (pdfinfo) |
Fehler (Exit 1) |
| Sind alle Wörter da und nur diese? | Wortmenge der Quelle gegen den aus dem Export zurückgelesenen Text (Link-Ziele sind kein Text) | Exit 2, Fehlend / Zusätzlich |
| Sind Zahlen und Fakten intakt? | Die Zeichen von Zahlen (% € $ + &) kommen gleich oft vor; jeder Stichpunkt steht mit denselben Wörtern in derselben Reihenfolge nach dem vorigen (von 800 ms auf 120 ms ist nicht von 120 ms auf 800 ms) |
Exit 2, Inhaltsabweichung |
| Stehen die Abschnitte in Ordnung? | Die Überschriften der Ebenen 1 und 2 folgen der Quelle (Heuristik) | Warnung Reihenfolge, Exit-Code unverändert |
| Hat die Datei die gewollte Struktur? | DOCX und HTML: Überschriften je Ebene gegen die Quelle, Tabellen, Textfelder, Bilder, Text in Kopf- und Fußzeilen | Warnung Struktur, Exit-Code unverändert |
| Ist sie zu lang? | Seitenlimit des Dokumenttyps (PDF) | Exit 4 |
| Ist sie versandfertig? | offene [ERGÄNZEN …] / [KLÄREN …] in der ganzen Datei |
Warnung, aufgelistet |
| Ist ein zweiter Lauf gleich? | --reproduce MANIFEST baut neu und vergleicht die Bytes |
Exit 3 bei Abweichung |
Zurückgelesen wird der reine Text der Datei: pdftotext bei der PDF, Absätze und Tabellenzellen bei DOCX, das HTML ohne
Tags, der LaTeX-Rumpf bei tex. Markdown ist eine Kopie der Quelle und wird als nicht_geprueft vermerkt. Zeilen- und
Seitenumbrüche, Trennstriche am Zeilenende, Aufzählungszeichen, die Seitenzahl und die Lage der Kopffelder gelten nicht
als Abweichung.
Was in diesem Repository getestet wird (tests/test_export.py, nur synthetische Daten) und was nicht:
| Aussage | Grundlage |
|---|---|
| Der Text der PDF lässt sich auslesen, die Stationszeile liest sich Zeitraum, Position, Arbeitgeber in dieser Reihenfolge, über mehrere Seiten geht keine Zahl und kein Zeichen verloren | getestet mit pdftotext |
| DOCX hat Word-Überschriftenformate in der Reihenfolge der Quelle, Aufzählungen, bei einem normalen Lebenslauf keine Tabelle; eine Tabelle oder ein Textfeld wird gemeldet | getestet mit python-docx |
HTML hat lang="de", Überschriften und Listen der Quelle |
getestet |
| Ein bestimmtes ATS liest die Datei richtig | nicht getestet und nicht behauptet. Parser unterscheiden sich in Regeln und Formaten, und echte Bewerbungsdaten gehen an keinen externen Parser |
| Der Text stimmt mit deiner Datengrundlage | vom Export nicht geprüft (cv_checks.py, Reviewer) |
| Das Layout sieht gut aus (Überlauf, hässlicher Seitenumbruch, Leerflächen) | nicht automatisch geprüft; öffne die PDF |
Wo die Prüfungen laufen: Die Tests für DOCX, HTML, Markdown und tex laufen in der CI bei jedem Pull Request (pandoc und
python-docx sind dort installiert). Die PDF-Tests brauchen LuaLaTeX und werden in der CI übersprungen. Sie laufen lokal oder im
Export-Image (dessen pandoc ist älter; der Exporter fängt das ab):
docker build -t claude-job-search-export .
docker run --rm --entrypoint sh -v "$PWD:/src:ro" claude-job-search-export \
-c 'cp -r /src /tmp/w && cd /tmp/w && python3 -m unittest tests.test_export'
Reproduzierbare PDFs¶
Eine Quelle mit dem Frontmatter-Schlüssel version_datum (JJJJ-MM-TT) ist eine festgeschriebene Version. Der
Export leitet dann Datum und PDF-ID der PDF aus der Quelle ab. Gleiche Quelle, gleiche Vorlage und gleiches
Container-Image ergeben eine byte-identische PDF. Ohne version_datum trägt die PDF den Tag des Exports, und der
Export gibt einen Hinweis aus.
python3 skills/job-application-export/scripts/export_document.py --reproduce lebenslauf.pdf.manifest.json
Der Befehl baut die Datei in einem temporären Ordner neu und vergleicht den Hash. Exit-Code 0 heißt identisch,
3 heißt abweichend oder geänderte Quelle; abweichende Werkzeugversionen werden aufgelistet. Bewahre das
Container-Image einer versendeten PDF auf (docker save), weil sich die Debian-Pakete darin mit der Zeit ändern.
Für Entwickler
Ausprägungen, Versionen und Ordneraufbau stehen in
spec/job-application/lebenslauf-versionen/en.md.
Im Container ausführen, in einem anderen Repository¶
Der Export läuft meist in dem Repository, das deine Bewerbungsdaten enthält, nicht im Plugin-Repository.
Das Dockerfile enthält pandoc, LuaLaTeX, die deutsche Sprachunterstützung und poppler-utils, dort muss
also nichts weiter installiert werden. Nötig ist nur Docker.
Baue das Image einmal. Das Plugin-Repository ist die Build-Quelle, du musst es nicht klonen:
docker build -t claude-job-search-export https://github.com/nolte/claude-job-search.git#develop
Ersetze develop durch das Release-Tag, zum Beispiel v0.2.0, damit sich das Image nicht unter dir ändert.
Starte es im Wurzelverzeichnis deines Daten-Repositories, dort liegt job-application/:
docker run --rm --user "$(id -u):$(id -g)" -v "$PWD:/work" claude-job-search-export \
job-application/<slug>/lebenslauf.md --format pdf --doc-type cv
--user "$(id -u):$(id -g)"sorgt dafür, dass die Dateien inexport/dir gehören. Das Image akzeptiert jede User-ID.- Das Ergebnis liegt in
job-application/<slug>/export/deines Repositories. Die Quelle wird nicht verändert. --format tex,docx,htmlundmdfunktionieren genauso.--name Vorname_Nachname_Lebenslaufsetzt den Dateinamen.- Starte den Befehl nach jeder Änderung am Lebenslauf neu. Eine alte PDF aktualisiert sich nicht von selbst.
Mit Task im Daten-Repository verkürzt diese Taskfile.yml den Aufruf:
version: '3'
vars:
EXPORT_IMAGE: '{{.EXPORT_IMAGE | default "claude-job-search-export"}}'
EXPORT_SOURCE: '{{.EXPORT_SOURCE | default "https://github.com/nolte/claude-job-search.git#develop"}}'
APPLICATION_ROOT: '{{.APPLICATION_ROOT | default "job-application"}}'
tasks:
export:image:
desc: Build the export image from the plugin repository
cmds:
- docker build -t {{.EXPORT_IMAGE}} {{.EXPORT_SOURCE}}
export:
desc: "Export a document: task export SLUG=<vorgang> [DOC=lebenslauf] [FORMAT=pdf] [TYPE=cv]"
requires:
vars: [SLUG]
vars:
DOC: '{{.DOC | default "lebenslauf"}}'
FORMAT: '{{.FORMAT | default "pdf"}}'
TYPE: '{{.TYPE | default "cv"}}'
cmds:
- >-
docker run --rm --user "$(id -u):$(id -g)" -v "$PWD:/work" {{.EXPORT_IMAGE}}
{{.APPLICATION_ROOT}}/{{.SLUG}}/{{.DOC}}.md --format {{.FORMAT}} --doc-type {{.TYPE}}
task export:image
task export SLUG=<slug>
task export SLUG=<slug> FORMAT=tex
Prüfe das Ergebnis nach jedem Export: Die Konsole muss Inhaltsprüfung: ok ausgeben und keine Zeile Reihenfolge: Abweichung oder Struktur: … (ein Abschnitt steht anders als in der Quelle, oder die Datei enthält eine Tabelle oder ein Textfeld; Warnungen, der Exit-Code bleibt 0). Eine PDF mit nur
wenigen Kilobyte und ohne Text ist ein fehlgeschlagener Export, auch wenn die Datei existiert. Nur der
Export-Skill wird ins Image kopiert (.dockerignore), personenbezogene Daten deines Repositories gelangen
also nie in den Build-Kontext.
Was der Export nicht tut¶
- Er ändert die Markdown-Quelle nie.
- Er fügt keine personenbezogenen Daten oder Metadaten hinzu, außer dem
grundlage_hashder Quelle. - Er versendet nichts. Der Versand ist ein eigener Schritt.