> For the complete documentation index, see [llms.txt](https://overleaf-pro.ayaka.space/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://overleaf-pro.ayaka.space/latex/de/ausfuhrliche-artikel/32-markdown-into-latex-with-style.md). # Markdown mit Stil in LaTeX **Aktualisierung nach der Veröffentlichung** (13. Mai 2017): Wir sind Vít Novotný, dem Autor/Betreuer des `Markdown` Pakets, dafür, dass er uns mit hilfreichem Feedback zum ursprünglichen Artikel geschrieben hat. Wir freuen uns, diese aktualisierte Version zu veröffentlichen, die seinen Rat und seine Vorschläge berücksichtigt und enthält. ### Einführung Vor einiger Zeit freuten wir uns über die Veröffentlichung des [`markdown-Pakets`](http://www.ctan.org/pkg/markdown) das es möglich machte, Markdown-Syntax in LaTeX-Dokumente zu schreiben – und feierten dies mit einem Artikel mit dem Titel [Wie man in Markdown auf Overleaf schreibt](/latex/de/ausfuhrliche-artikel/30-how-to-write-in-markdown-on-overleaf.md) dessen Zweck es war, einige der unterstützten Syntax zu demonstrieren. **Merke**: Du musst deine `.tex` Dateien mit der `--shell-escape` Option kompilieren, damit es in lokalen LaTeX-Installationen funktioniert – Overleaf erledigt das für dich (automatisch). Beachte, dass die meisten Einreichungsportale für Zeitschriften `--shell-escape`—es sei denn, du darfst nur das Ausgabe-PDF deines Manuskripts hochladen, werden deine markdown enthaltenden LaTeX-Dateien möglicherweise nicht erfolgreich kompiliert, wenn sie vom Einreichungssystem des Verlags verarbeitet werden. Eine der im [früheren Artikel](/latex/de/ausfuhrliche-artikel/30-how-to-write-in-markdown-on-overleaf.md) angedeuteten Ideen ist, dass eine Kombination aus Markdown und LaTeX eine wunderbare Trennung von Inhalt und Stil ermöglicht. Autorinnen und Autoren (insbesondere diejenigen, die bereits mit Markdown vertraut sind) hätten mit einigen Vorbehalten eine wesentlich knappere Syntax zur Verfügung und hätten dennoch Zugriff auf all die Vorzüge von LaTeX-Paketen und -Vorlagen, die sich um Stil und Formatierung kümmern. Das [früheren Artikel](/latex/de/ausfuhrliche-artikel/30-how-to-write-in-markdown-on-overleaf.md) gab einige Beispiele für die Verwendung von Markdown in [Beamer-Präsentationen](https://www.overleaf.com/read/dnrwnjrpjjhw) und [Poster](https://www.overleaf.com/read/jtbgmmgqrqmh): heute schauen wir uns noch mehr unterhaltsame und spannende Gestaltungsmöglichkeiten an! ### Verwendung von Markdown in gestylten LaTeX-Vorlagen Abgesehen von den obigen Beispielen kannst du Markdown in fast allen Vorlagen verwenden. Hier sind ein paar kurze Beispiele: * Die [Legrange-Orange-Buch](https://www.overleaf.com/latex/templates/the-legrand-orange-book-template-english/jtctyfmnpppc) Vorlage * Die [Von Tufte inspirierte Handreichung](https://www.overleaf.com/latex/templates/handout-design-inspired-by-edward-tufte/dtsbhhkvghzz) Vorlage * Diese [sehr schönes Artikel-Template](https://www.overleaf.com/read/xfsrpsmdtqvt) von Thiago Du wirst vielleicht bemerken, dass zwei davon Artikelvorlagen und eine eine Buchvorlage sind. Die [`markdown-Pakets`](http://www.ctan.org/pkg/markdown) erkennt, ob der `\chapter` Befehl in einem bestimmten LaTeX-Dokument verfügbar ist und wird die Zeile der ersten Überschrift `Markdown` als `\chapter` oder `\section` angemessen. ### Sehr schnelle Handouts: Markdown + PocketMod Seit ich zum ersten Mal von Markdown erfuhr, erschien es mir als schnelle und bequeme Art, Notizen zu machen: Es spiegelt wider, wie ich auf Papierfetzen oder Haftnotizen Notizen kritzeln könnte – besonders mit der Syntax für Aufzählungs- und nummerierte Listen. Als ich die [PocketMod-Vorlage](https://www.overleaf.com/read/nqbhpnrkskrx) 2015 erstellt hatte, sehnte ich mich nach einer Möglichkeit, Markdown in LaTeX zu schreiben, damit ich PocketMods *mit* Markdown, weil es sich… passend anfühlte. Notizen in einer einfachen Syntax auf kleinen gefalteten Heftchen festzuhalten, aber mit schöner Typografie – manche bezeichnen PocketMods als „Zines“, weil sie kleine 8-seitige Hefte sind, die man aus einem einzigen A4-Blatt herstellen kann. Und tatsächlich war es möglich! Dadurch lässt sich recht einfach schnell ein [Mini-Heftchen als Wochenplaner](https://www.overleaf.com/read/zfzcxygqwqsq) oder ein kleines [Bildergeschichtenbuch](https://www.overleaf.com/read/rppnsfgnrhsf). Ja, es hielt meine Tochter ganze 10 Minuten lang bei Laune, als sie ein Bilderbuch aus ihren eigenen Zeichnungen sah… nun ja, für ganze 10 Minuten! Die [`markdown-Pakets`](http://www.ctan.org/pkg/markdown) ermöglicht es dir anzupassen, wie jede Markdown-Syntax in LaTeX gerendert wird, also habe ich die Standard- `![](img_file "caption")` Syntax so umdefiniert, dass die Bildunterschrift unter die Bilddatei gesetzt wird (ohne Präfix „Figure“ oder Nummerierung), und dann einen Seitenumbruch eingefügt. Das macht es noch einfacher, das Bilderbuch zu erstellen. Hier ist ein Video, das zeigt, wie man das Heftchen faltet: {% embed url="" %} ### Einfache Rezepthefte Wenn man darüber nachdenkt, besteht ein Rezept aus Listen: einer Liste von Zutaten, einer Liste von Vorbereitungs- oder Kochanweisungen und vielleicht einer Liste von Notizen (Kochzeit, Portionen usw.). Also statt dies zu schreiben: ```latex \begin{enumerate} \item Mach zuerst dies \item Dann mach das ... \end{enumerate} ``` Ich würde es definitiv begrüßen, dies schreiben zu können: ``` #. Mach zuerst dies #. Dann mach das ``` Und entsprechend für die Zutaten: ``` - 2 Eier - Prise Salz ``` Um also schnell und einfach ein Rezept zu erstellen, können wir dies schreiben: ``` # Rührei Kochzeit : 5 Minuten Portionen : 1 ## Zutaten - 4 Eier - 1 TL Butter - 1/4 Tasse Milch - Salz, Pfeffer (nach Geschmack) ## Anweisungen #. Eier, Milch verquirlen... #. Butter in der Pfanne erhitzen... #. ... ``` Hmm, das sieht vielversprechend aus. Einige von uns bei Overleaf (und unsere Familien) steuerten unsere Lieblingsrezepte für die schnelle Küche bei (ideal für Kochanfänger), und ich habe schnell ein – Verzeihung für das Wortspiel – ein [Vorlage für schnelle Rezepte](https://www.overleaf.com/read/gscqdhnwzsfg) das du mit Markdown schreiben kannst *und* zu einem Mini-Heftchen machen. [![A recipe booklet produced on Overleaf using markdown](/files/73819d9aa90c52e2fe0c5b8fe20bdb1c81ae1039)](https://www.overleaf.com/read/gscqdhnwzsfg) Nun kommt noch ein weiterer Spaßfaktor. Unter der Haube ist das immer noch LaTeX, also können wir die verschiedenen Elemente weiterhin gestalten – Überschriften, Aufzählungslisten, Schriftarten und so weiter – mit dem üblichen LaTeX-Werkzeugkasten. Das war der Punkt, an dem ich es ziemlich übertrieben habe und auf *drei* „Themes“ für die `simple-recipe` Klasse! ### Bonus 1: Einige Vorbehalte bei der Verwendung des markdown-Pakets * SyncTeX funktioniert nicht ganz. Auf Overleaf bedeutet das, dass die Operationen „Position in der Vorschau“ und „In der Vorschau klicken, um zur Quelle zu springen“ in den `Markdown` Bereichen nicht funktionieren. * `\\` verliert seine normale Bedeutung: Der übliche „zwei Leerzeichen gefolgt von einer neuen Zeile“- `Markdown` Trick funktioniert hier nicht, weil nachgestellte Leerzeichen vom Lua-Parser entfernt werden, wie in der [`Markdown` Paketdokumentation](http://texdoc.net/pkg/markdown). `\newline` allerdings funktionieren. * Sei vorsichtig bei mehreren Unterstrichzeichen in derselben Zeile – das kann problematisch sein, wenn: * du in deinen Gleichungen mit vielen Indizes arbeitest (Tipp: wechsle in solchen Fällen aus der `Markdown` Umgebung aus); * du gern Unterstriche in deinen BibTeX-Schlüsseln verwendest. Du kannst `underscores=false` mit den neuesten `markdown-Pakets` Dateien setzen, damit Unterstriche für Indizes funktionieren, aber Unterstriche in BibTeX-Schlüsseln funktionieren immer noch nicht. **Aktualisierung** (13. Mai 2017): Unterstriche in BibTeX-Schlüsseln funktionieren mit `Markdown` Version 2.5.2 und neuer – danke, Vít! * Du wirst einige Schwierigkeiten haben, ein literales Rautezeichen anzuzeigen, denn nicht einmal `\#` funktioniert! Ich definiere dafür normalerweise einen neuen Befehl und verwende stattdessen diesen. ### Bonus 2: Neue Funktionen im aktualisierten markdown-Paket `Markdown` Version 2.4 und später fügten Unterstützung für einige wirklich schöne Syntax hinzu: * **Inline-Fußnotensyntax**: `...^[das ist die Fußnote]` (erfordert die `inlineFootnotes` Option) * **Zitate:**`[@smith1990]` (erfordert die `Zitate` Option; achte außerdem auf Unterstriche in deinen BibTeX-Schlüsseln!) * **Codeblöcke**: Du kannst entweder Tilden `~` oder Backticks `` ` `` als Trenner verwenden. ``` ~~~~ int main() { cout << "Hello world!"; return 0; } ~~~~ ``` Wenn du diese neuen Funktionen verwenden möchtest, lade unbedingt aktualisierte Versionen von `markdown.lua`, `markdown.tex` und `markdown.sty` in dein Projekt hoch – oder du kannst einfach ein neues Projekt erstellen aus [dieser Vorlage](https://www.overleaf.com/read/whdrnpcpnwrm). --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://overleaf-pro.ayaka.space/latex/de/ausfuhrliche-artikel/32-markdown-into-latex-with-style.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.