docs: Bedienungsanleitung um Umwandlung in andere Formate ergänzt

Getestete Befehle für HTML, EPUB, Word, ODT, PDF (LaTeX über HTML bzw.
weasyprint) und Kindle (AZW3 via Calibre), aus der Gesamtdatei wie aus
den Kapiteldateien, mit Installationshinweisen.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

BEDIENUNGSANLEITUNG.md

@@ -14,7 +14,7 @@ was du mit dem Ergebnis anfangen kannst. Technische Details stehen in der [READM
 - auf Wunsch zusätzlich **eine einzige Markdown-Datei mit dem ganzen Buch** (`epub2md_merge.py`)
 
 Markdown ist reiner Text mit einfachen Formatierungszeichen. Du kannst ihn in jedem Editor lesen,
-in Obsidian ablegen, mit Git versionieren, mit Pandoc in HTML/PDF/Word umwandeln oder an ein lokales
+in Obsidian ablegen, mit Git versionieren, mit Pandoc in HTML/PDF/EPUB/Word umwandeln oder an ein lokales
 Sprachmodell (RAG) übergeben.
 
 Was das Programm **nicht** kann:
@@ -224,24 +224,69 @@ erscheinen als einzelne Notizen, Bilder und Links auf andere Kapitel funktionier
 als Eigenschaften angezeigt. Sprünge an eine bestimmte Stelle *innerhalb* eines Kapitels (HTML-Anker wie
 `<a id="…">`) unterstützt Obsidian nur eingeschränkt. Solche Links öffnen dann einfach das Kapitel.
 
-### Mit Pandoc in HTML, PDF oder EPUB umwandeln
+### In andere Formate umwandeln (HTML, PDF, EPUB, Word …)
 
-Am einfachsten über die Gesamtdatei. Wechsle dazu in den Ausgabeordner, damit die Bildpfade stimmen:
+Dafür eignet sich **Pandoc**; für Kindle-Formate kommt **Calibre** (`ebook-convert`) dazu. Beide sind
+eigenständige Programme und nicht Teil von epub2md. Installation unter Ubuntu:
+`sudo apt install pandoc calibre`. Für PDF zusätzlich entweder LaTeX
+(`sudo apt install texlive-xetex`) oder `pip install weasyprint`.
+
+> **Wichtig:** Die Befehle im Ordner der jeweiligen Datei ausführen. Sonst findet Pandoc die Bilder nicht,
+> weil die Bildpfade relativ angegeben sind.
+
+#### Aus der Gesamtdatei (empfohlen)
 
 ```bash
-python3 epub2md_merge.py output/meinbuch
+python3 epub2md_merge.py output/meinbuch    # erzeugt output/meinbuch/meinbuch.md
 cd output/meinbuch
-pandoc meinbuch.md --toc -s -o meinbuch.html              # Webseite
-pandoc meinbuch.md --toc -o meinbuch.docx                 # Word
-pandoc meinbuch.md -s -o meinbuch.html && \
-  pandoc meinbuch.html --toc --pdf-engine=xelatex -o meinbuch.pdf   # PDF (LaTeX nötig)
 ```
 
+`meinbuch.md` steht im Folgenden für den Namen der Gesamtdatei. Er entspricht dem Namen des
+Original-E-Books.
+
+| Ziel | Befehl |
+| --- | --- |
+| Webseite (HTML) | `pandoc meinbuch.md -s --toc -o meinbuch.html` |
+| Webseite mit Formeln | `pandoc meinbuch.md -s --toc --mathml -o meinbuch.html` |
+| E-Book (EPUB) | `pandoc meinbuch.md --toc -o meinbuch.epub` |
+| Word | `pandoc meinbuch.md -o meinbuch.docx` |
+| LibreOffice | `pandoc meinbuch.md -o meinbuch.odt` |
+| PDF mit LaTeX | `pandoc meinbuch.md -s -o meinbuch.html && pandoc meinbuch.html --toc --pdf-engine=xelatex -o meinbuch.pdf` |
+| PDF ohne LaTeX | `pandoc meinbuch.md --toc --pdf-engine=weasyprint -o meinbuch.pdf` |
+| Kindle (AZW3) | `pandoc meinbuch.md --toc -o meinbuch.epub && ebook-convert meinbuch.epub meinbuch.azw3` |
+
+**Zum PDF:**
+
+- **Mit LaTeX** immer den Zwischenschritt über HTML nehmen, wie in der Tabelle. Beim direkten Weg von
+  Markdown nach LaTeX lässt Pandoc komplexe Tabellen weg, und Querverweise im PDF funktionieren nicht. Bei
+  Büchern mit Formeln ist der LaTeX-Weg die beste Wahl.
+- **Mit weasyprint** genügt ein Schritt; Tabellen bleiben erhalten. Für Bücher mit vielen Formeln ist der
+  LaTeX-Weg sicherer.
+
 Bei Büchern mit Formeln für HTML zusätzlich `--mathml` angeben, sonst bleiben Matrizen als TeX-Text stehen.
 
-Für ein PDF immer den Umweg über HTML nehmen, wie oben gezeigt. Beim direkten Weg von Markdown nach PDF
+#### Direkt aus den Kapiteldateien
-lässt Pandoc komplexe Tabellen weg, und Querverweise im PDF funktionieren nicht. Die `README.md` im
+
-Ausgabeordner enthält die passenden Befehle für dein Buch.
+Ohne Gesamtdatei geht es auch. Dann im Ordner `chapters/` arbeiten und die Buchdaten aus
+`metadata.yaml` mitgeben:
+
+```bash
+cd output/meinbuch/chapters
+pandoc *.md --metadata-file=../metadata.yaml -s --toc -o ../meinbuch.html
+pandoc *.md --metadata-file=../metadata.yaml --toc -o ../meinbuch.epub
+```
+
+Das Ergebnis entspricht dem der Gesamtdatei. Querverweise zwischen Kapiteln funktionieren aber nur in der
+Gesamtdatei zuverlässig. Bei Büchern mit vielen Verweisen also lieber die Gesamtdatei verwenden. Für PDF
+gilt hier derselbe Umweg über HTML.
+
+#### Weitere Formate und Tipps
+
+- Pandoc kennt viele weitere Formate, z. B. `.rtf`, `.txt`, `.tex` (LaTeX-Quelltext), `.rst` oder
+  `.adoc`. Meist genügt `-o datei.<endung>`. Alle Formate zeigt `pandoc --list-output-formats`.
+- Wurde mit `--math tex` umgewandelt, braucht Pandoc zusätzlich `-f markdown+tex_math_single_backslash`.
+- Die `README.md` im Ausgabeordner enthält im Abschnitt „Weiterverarbeitung“ die passenden Befehle mit
+  dem richtigen Dateinamen. Bei Büchern mit Formeln steht `--mathml` dort schon dabei.
 
 ### Für ein lokales Sprachmodell (RAG)