> 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/30-how-to-write-in-markdown-on-overleaf.md).
# Wie man in Markdown auf Overleaf schreibt
**Aktualisierung nach der Veröffentlichung** (hinzugefügt am 13. Mai 2017): Wir sind Vít Novotný, dem Autor/Betreuer des `Markdown` Pakets dankbar, dass er uns mit hilfreichem Feedback zum Originalartikel geschrieben hat. Wir freuen uns, diese aktualisierte Version zu veröffentlichen, die seinen Rat und seine Vorschläge berücksichtigt und enthält.
### Hä, was?
[Markdown](https://kirkstrobeck.github.io/whatismarkdown.com/) ist eine leichtgewichtige Auszeichnungssprache (verstanden? 😉), mit der Sie etwas in einfachem Text mit einigen *sehr* einfachen Regeln schreiben und es dann in formatierte Ausgaben, z. B. HTML, umwandeln können. Sie ist bei Softwareentwicklern und Programmierern sehr beliebt, gerade wegen ihrer Einfachheit (und, darf ich hinzufügen, auch perfekt für Notizen!).
Zum Beispiel, um eine schnelle Einkaufsliste zu schreiben:
```
# Einkaufsliste
*Denken Sie daran*, während der kommenden [Sonderangebote](http://acme-marg.com) so viel wie möglich mitzunehmen!
## Lebensmittel
- Bohnen in Tomatensauce
- Spaghetti
## Schreibwaren
- Schreibblock
- Bleistifte
```
Und Sie erhalten als HTML-Ausgabe, wenn Sie ein Werkzeug wie [pandoc](http://pandoc.org/):
```html
Einkaufsliste
Denken Sie daran, während der kommenden Sonderangebote so viel wie möglich mitzunehmen!
Lebensmittel
- Bohnen in Tomatensauce
- Spaghetti
Schreibwaren
```
Schön und einfach! Weitere Syntax für Markdown finden Sie [hier](https://daringfireball.net/projects/markdown/syntax).
### Was bedeutet das also für mich?
Viele LaTeX-Anwender sind mit ihren schön gesetzten LaTeX-Dokumenten zufrieden, können aber ein wenig Neid auf Markdown-Nutzer nicht unterdrücken – denn nun ja, die LaTeX-Auszeichnung *kann* wird mitunter recht ausführlich. Ja, Listen, wir schauen euch *an*...
Die gute Nachricht ist, dass das fantastische neue [`Markdown` LaTeX-Paket](https://ctan.org/pkg/markdown) ermöglicht es Ihnen, Markdown-Syntax in Ihren LaTeX-Dokumenten zu schreiben (also einfachere Eingaben) und trotzdem wunderschön gesetzte PDFs zu erhalten! Alles, was Sie tun müssen, ist das `Markdown` Paket in Ihr Dokument zu laden und Ihr Markdown-Material in ein `Markdown` Umgebung verwenden müssen:
```latex
\documentclass{article}
\usepackage{markdown}
\begin{document}
\begin{markdown}
# Einkaufsliste
*Denken Sie daran*, während der kommenden [Sonderangebote](http://acme-marg.com) so viel wie möglich mitzunehmen!
## Lebensmittel
- Bohnen in Tomatensauce
- Spaghetti
## Schreibwaren
- Schreibblock
- Bleistifte
\end{markdown}
\end{document}
```
Oder wenn Sie Ihr Markdown-Material lieber in eine `*.md` Datei legen:
```latex
\documentclass{article}
\usepackage{markdown}
\begin{document}
\markdownInput{example.md}
\end{document}
```
Klasse! Das wird Entwicklertypen höchstwahrscheinlich sehr glücklich machen, denn sie können jetzt einfach ihre `.md` Dokumentation!
### Kann ich trotzdem LaTeX-Befehle verwenden, wenn ich Markdown schreibe?
Ja, Sie können in Ihrem Markdown-Material weiterhin LaTeX-Befehle verwenden! Übergeben Sie einfach die `hybrid` Option an `Markdown`:
```latex
\usepackage[hybrid]{markdown}
...
- Schreibblock (die Art mit dem großen $E=mc^2$ auf dem Umschlag)
```
### Wie kann ich wörtliche Zeichen wie '#' und '\_' (Unterstriche) verwenden?
#### Ein '#'-Zeichen eingeben
Sie können das Zeichen '#' nicht eingeben *innerhalb der `Markdown` Umgebung*. Nicht einmal `\#` funktioniert. Sie müssen einen Befehl definieren wie `\newcommand{\texthash}{\#}`, und dann `\texthash` in Ihre `Markdown` Umgebung verwenden. Entsprechend gilt das für Unterstriche, insbesondere wenn es mehr als einen in derselben Zeile gibt, z. B. `$y = m_1 + n_2$`. Manchmal kann es einfacher sein, die aktuelle `Markdown` Umgebung zu beenden und problematische Zeilen im normalen LaTeX-Modus zu schreiben und dann eine weitere `Markdown` Umgebung.
#### Das Eingeben von '\_' (Unterstrich) und '\`' (Gravis)
**Aktualisierung** (hinzugefügt am 13. Mai 2017): Seit `Markdown` Version 2.5 können Sie `underscores = false` und `codeSpans = false` zum Deaktivieren von Unterstrichen und Backticks setzen. Dadurch ist es möglich, mathematische Indizes und Anführungszeichen im Hybridmodus ohne Maskierung zu schreiben. Für Hervorhebungen haben wir Sternchen, sodass wirklich nur Inline-Codebeispiele verloren gehen. Danke, Vít, für den Tipp!
#### Zu vermeidende Umgebungen...
Und obwohl Sie Backticks verwenden können, um Inline-Verbatim zu schreiben, oder die Zeile mit vier Leerzeichen einrücken können für einen Verbatim-Block, verwenden Sie nicht `lstlisting` noch `minted` LaTeX-Umgebungen innerhalb von `Markdown` Umgebungen. Tun Sie es einfach nicht.
#### HTML in einer Markdown-Umgebung verwenden
Und nein, Sie können HTML innerhalb der LaTeX- `Markdown` Umgebung nicht verwenden (auch wenn das in normalem Markdown üblich ist). Sorry.
**Aktualisierung** (hinzugefügt am 13. Mai 2017): Seit `Markdown` v2.3 gibt es eine `html` Option, die HTML-Tags nicht wörtlich anzeigt, wenn sie in Ihrem Markdown-Material vorhanden sind, allerdings wird der Inhalt der Tags auch nicht formatiert — d. h. `Hallo!` wird Hello! einfach in normaler Schriftstärke anzeigen. Aber HTML-Entitäten wie `©` werden als © dargestellt. Danke an Vít für den Hinweis.
### Vorgeschlagene Paketoptionen für Markdown
Ein Satz von `Markdown` Paketoptionen, die Sie nützlich finden könnten, ist:
```latex
\usepackage[footnotes,definitionLists,hashEnumerators,smartEllipses,hybrid]{markdown}
```
Diese Optionen ermöglichen die Verwendung von
* Markdown-Syntax für Fußnoten (wie `[^1]`);
* Definitionslisten und `#` für nummerierte Listen;
* „richtigen“ Auslassungspunkten (…).
Hier ist ein [vollständiges Beispiel](https://www.overleaf.com/latex/examples/using-markdown-in-latex-documents/whdrnpcpnwrm) in der Overleaf-Galerie, und hier ist [ein weiteres](https://www.overleaf.com/articles/how-to-write-using-rich-text-format-and-markdown-in-latex-and-overleaf/dbqrxvftzskw).
### Hyperlinks und Fußnoten: wie?
Im Overleaf-Beispiel ist der Hyperlink eine Fußnote. Wie mache ich daraus einen Hyperref-Hyperlink?
`Markdown` ist anpassbar, sodass Sie definieren können, wie verschiedene Elemente dargestellt werden sollen. Wenn Sie diese zu Ihrer Präambel hinzufügen, tun Sie genau das:
```latex
\markdownSetup{renderers={
link = {\href{#2}{#1}}
}}
```
**Aktualisierung** (hinzugefügt am 13. Mai 2017): `rendererPrototypes` wurde in der ersten Version verwendet. Normale Benutzerinnen und Benutzer sollten `renderers` für ihre eigenen Definitionen verwenden, da `rendererPrototypes` dazu da ist, dass Paket-Ersteller Standardwerte bereitstellen. Wenn Sie `rendererPrototypes`ändern, laufen Sie Gefahr, dass ein anderes Paket Ihre Einstellungen überschreibt. Danke an Vít für den Hinweis!
### Einbinden von Bildern (aktualisiert am 8. November 2022)
* **Hinweis**: Das nächste Beispiel verwendet eine Grafikdatei (`example-image.pdf`) bereitgestellt vom `mwe` Paket. Diese Grafikdateien werden mit TeX Live verteilt und sind daher auf den Servern von Overleaf gespeichert, wodurch sie als Bildplatzhalter verfügbar sind, wie im folgenden Beispiel.
Bilder können in Markdown eingebunden werden, indem Markup im folgenden Format geschrieben wird:
```latex
```
Hoffentlich beschreiben die Parameternamen `Alternativtext`, `Dateiname` und `"Bildunterschrift"` erklären, was sie tun. Hier ist ein Beispiel, das sie veranschaulicht:
```latex
\documentclass{article}
\usepackage[hybrid]{markdown}
% Das mwe-Paket stellt Beispielbilder bereit. Das Laden ist
% nicht unbedingt erforderlich, da sich diese Bilder im Suchpfad von LaTeX befinden.
% Hier laden wir es zur Verdeutlichung in diesem Beispiel.
\usepackage{mwe}
\begin{document}
\begin{markdown}
Dieses Beispiel zeigt, wie man eine Grafikdatei importiert. Hier verwenden wir ein
Beispielbild, das vom `mwe`-Paket bereitgestellt wird.
% Verwenden Sie \setkeys{Gin}, wenn Sie die Anzeigengröße eines Bildes ändern müssen
\setkeys{Gin}{width=.5\linewidth}
\end{markdown}
\end{document}
```
[Öffnen Sie dieses Beispiel auf Overleaf.](https://www.overleaf.com/docs?engine=pdflatex\&snip_name=Using+images+in+markdown\&snip=%5Cdocumentclass%7Barticle%7D%0A%5Cusepackage%5Bhybrid%5D%7Bmarkdown%7D%0A%25+The+mwe+package+provides+example+images.+Loading+it+is%0A%25+not+essential+because+those+images+are+in+LaTeX%27s+search+path.+%0A%25+Here%2C+we+load+it+for+clarity+in+this+example.%0A%5Cusepackage%7Bmwe%7D%0A%5Cbegin%7Bdocument%7D%0A%5Cbegin%7Bmarkdown%7D%0AThis+example+shows+how+to+import+a+graphics+file.+Here+we+are+using+an%0Aexample+image+provided+by+the+%60mwe%60+package.%0A%0A%25+Use+%5Csetkeys%7BGin%7D+if+you+need+to+change+an+image%27s+display+size%0A%0A%5Csetkeys%7BGin%7D%7Bwidth%3D.5%5Clinewidth%7D%0A%21%5BThis+is+alt+text+to+describe+my+image.%5D%28example-image.jpg+%22An+example+image+provided+by+the+%5Ctexttt%7Bmwe%7D+package.%22%29%0A%5Cend%7Bmarkdown%7D%0A%5Cend%7Bdocument%7D)
Dieses Beispiel erzeugt die folgende Ausgabe:
#### Hinweis zur Bildbreite
Wie die meisten Pakete, `Markdown` lädt es andere Pakete, einschließlich [`keyval`](https://ctan.org/pkg/keyval?lang=en) und [`graphicx`](https://ctan.org/pkg/graphicx?lang=en), um die von ihnen bereitgestellten Befehle und Funktionen zu nutzen. Hier wird die Bildbreite mithilfe des `\setkeys` Befehls festgelegt, der von `keyvals`. `Gin` ist eine "Familie" von Schlüsseln, die vom `graphicx` Pakets erkunden.
* **Hinweis**: Da ein LaTeX-Befehl, hier `\setkeys`\setkeys *verwendet wird* Der Stil `Markdown` innerhalb der Umgebung ist die `hybrid` Option des markdown-Pakets erforderlich.
#### Bezeichner für die Platzierung von Floats ändern (fortgeschrittener)
Die Markdown-Syntax zum Einfügen von Abbildungen erlaubt es Ihnen nicht, die Bezeichner für die Platzierung von Floats direkt anzugeben, aber Sie können sie anpassen, indem Sie neu definieren, wie die Abbildung gerendert wird:
```latex
\markdownSetup{renderers={
image = {\begin{figure}[hbt!]
\centering
\includegraphics{#3}%
\ifx\empty#4\empty\else
\caption{#4}%
\fi
\end{figure}}
}}
```
Weitere Informationen finden Sie in der [Markdown-Dokumentation](https://mirror.apps.cam.ac.uk/pub/tex-archive/macros/generic/markdown/markdown.html).
### Können Sie mit Markdown in LaTeX Tabellen erstellen? 😀
Leider nein. Tabellen werden in [MultiMarkdown](http://fletcherpenney.net/multimarkdown/) nur unterstützt, und das LaTeX- `Markdown` Paket unterstützt dies derzeit nicht.
**Aktualisierung** (hinzugefügt am 13. Mai 2017): Auf Grundlage eines Hinweises von Vít ist es möglich, die `contentBlocks` Syntax-Erweiterung seit Version 2.4 zu verwenden oder den `inputFencedCode` Renderer anzupassen, um etwas CSV-artigen Text schnell in eine Tabelle umzuwandeln.
### Noch mehr nützliche Funktionen des Markdown-Pakets...?
Wie bereits erwähnt, ist es eine coole Methode zum Notizenmachen, und in Kombination mit einigen schönen LaTeX-Dokumentklassen oder Paketkonfigurationen ermöglicht sie Ihnen am Ende einer Vorlesung ein schönes Skript direkt zu haben. Zum Beispiel könnten Sie es mit den [Tufte-Klassen](https://www.overleaf.com/gallery/tagged/tufte):
```latex
\documentclass{tufte-handout}
\usepackage[footnotes,definitionLists,hashEnumerators,smartEllipses, hybrid]{markdown}
\begin{document}
\markdownInput{PHY303-lecture-12Nov2016.md}
\end{document}
```
Und die kurze und einfache Syntax, die das Schreiben von Listen viel bequemer macht, bedeutet, dass wir jetzt eine *wirklich schnelle* Art des Schreibens von [Beamer-Präsentationen](https://www.overleaf.com/latex/examples/writing-beamer-slides-with-markdown/dnrwnjrpjjhw) und [Poster](https://www.overleaf.com/latex/examples/writing-beamer-slides-with-markdown/dnrwnjrpjjhw)!
Viel Spaß!
---
# 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/30-how-to-write-in-markdown-on-overleaf.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.