Powered by Typst & Python

Moderne PDF-Dokumente aus strukturiertem Markdown

markpublish setzt Markdown-Kapitel in druckreife, hochwertige PDFs — Deckblatt, Verzeichnisse und Kopfzeilen entstehen automatisch.

$ pip install markpublish
Handbücher & Quickstart
Keine externen Compiler-Binaries
Blitzschnelle Kompilierung
Freie MIT-Lizenz

Automatische Struktur
und visuelle Akzente

Ein PDF aus vielen Markdown-Dateien: Nummerierung, Verzeichnisse und Kopfzeilen bleiben über alle Kapitel hinweg synchron.

Professionelle Dokumente
out-of-the-box

Keine Probleme mit komplizierten Pipelines

Ein Manifest für alles

Titel, Deckblatt, Verzeichnisse sowie die Reihenfolge der Kapitel werden zentral in markpublish.yaml definiert.

Kapitel & Trennseiten

Abschnitte und Kapitel erhalten auf Wunsch stilvolle Trennseiten mit Untertitel und eigenem lokalem Teil-Inhaltsverzeichnis.

Musterbasierte Nummerierung

Muster wie "1|.1|+", "A|.1|+" oder "I|1|.1|+" steuern die Nummerierung. Frei anpassbare Präfixe („Kapitel“, „Anhang“) sind möglich.

Themen in Typst

Mit markpublish export-template kann das default-Theme exportiert und angepasst werden.

Markdown, das mehr kann

GitHub-style Alerts ([!NOTE], [!WARNING]), Fußnoten, Aufgabenlisten, Definitionslisten, Mathe in LaTeX-Schreibweise und erstklassiges Code-Highlighting.

Mehrsprachig gedacht

Flexible Mehrsprachigkeit auch für statische Texte in Templates — aktuell Deutsch und Englisch.

Keine manuellen Abhängigkeiten

Kein separates Typst-Binary oder Pandoc-Setup nötig. Der Typst-Compiler wird direkt über offizielle Python-Wheels eingebettet.

Selbst-dokumentierend

markpublish cheatsheet und markpublish manual generieren die Handbücher direkt aus dem installierten Paket — immer versionsgenau.

In 3 Schritten zum ersten Dokument

Installieren, Projekt anlegen, PDF bauen — fertig.

bash — markpublish workflow
# 1. markpublish installieren (benötigt Python 3.10+)
$ pip install markpublish
 
# 2. Projekt anlegen — erzeugt markpublish.yaml und welcome.md
$ markpublish init mein-dokument
[OK] markpublish-Projekt eingerichtet in mein-dokument
markpublish build mein-dokument/markpublish.yaml erzeugt Ihr erstes PDF.
 
# 3. Druckreifes PDF kompilieren (Dateiname aus dem Dokumententitel)
$ markpublish build mein-dokument/markpublish.yaml
[OK] PDF erfolgreich erzeugt: mein-dokument/mein_dokument.pdf

Handbücher & Kurzreferenzen

Alle Handbücher wurden vollständig mit markpublish selbst gesetzt. Direkt als PDF herunterladen oder im Browser ansehen.

Umfassendes Handbuch

Benutzerhandbuch

Vollständige Anleitung zu Konfiguration, Typst-Integration, Kapiteln, Metadaten und CLI-Befehlen.

Kompakte Übersicht

Kurzreferenz

Kompakte Referenz aller Syntaxelemente, Autonumbering-Muster, YAML-Optionen und Tastenkürzel.

Complete Guide

User Manual

Comprehensive guide covering configuration, Typst integration, numbering patterns, and CLI options.

Cheatsheet

Quick Reference

Compact cheat sheet covering all syntax, YAML manifest parameters, formatting rules and commands.