> 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/wissensdatenbank/166-writing-markdown-in-latex-documents.md).

# Markdown in LaTeX-Dokumenten schreiben

## Einführung

Um Markdown in einem LaTeX-Dokument zu verwenden, müssen Sie das [`Markdown` Paket](https://www.ctan.org/pkg/markdown) in Ihrer Dokumentpräambel einbinden:

```latex
\usepackage[settings]{markdown}
```

wobei `[settings]` ist ein *optionaler* Parametersatz, der verwendet wird, um bestimmte Paketfunktionen zu konfigurieren oder zu aktivieren. Siehe die `Markdown` Paket [Dokumentation](https://anorien.csc.warwick.ac.uk/mirrors/CTAN/macros/generic/markdown/markdown.html) für eine [Beschreibung der Paketparameter (Optionen)](https://anorien.csc.warwick.ac.uk/mirrors/CTAN/macros/generic/markdown/markdown.html#options).

Dieser Artikel gibt einen kurzen Überblick über beide *Inline-* Markdown – innerhalb Ihres Dokuments geschrieben – und das Importieren von *external* Markdown, das in einer Textdatei enthalten ist.

* **Hinweis**: Im Allgemeinen sollte die Verwendung von Markdown innerhalb eines LaTeX-Dokuments als ergänzende und praktische Option zum Verfassen einiger Elemente des Inhalts Ihres Dokuments betrachtet werden, nicht als alternative Syntax, die LaTeX vollständig ersetzt.

## Verwendung externer Markdown-Dateien

Verwenden Sie den Befehl

```latex
\markdownInput{filename}
```

um die Markdown-Datei `filename`.

Das folgende Beispiel fügt eine Datei namens `example.md`. Verwenden Sie den Link unter den Code-Auflistungen, um sie als Overleaf-Projekt zu öffnen:

**`main.tex`**

```latex
\documentclass{article}
\title{Verwendung des markdown-Pakets}
\usepackage[smartEllipses]{markdown}
\begin{document}

\markdownInput{example.md}

\end{document}
```

**`example.md`**

```latex
%% example.md

# Ich bin eine Markdown-Datei.

Und ich kann *Betonung*.
## Mit Unterüberschriften

> Blockzitate sind
> so geschrieben.
>
> Sie können mehrere Absätze umfassen,
> wenn Sie möchten.

Verwenden Sie 3 Bindestriche für einen Gedankenstrich. Verwenden Sie 2 Bindestriche für
Bereiche (z. B. „es steht alles in den Kapiteln 12--14“).
Drei Punkte ... werden in Auslassungspunkte umgewandelt
(vorausgesetzt, Sie fügen die smartEllipses-Option
in Ihrer Präambel hinzu). Unicode wird unterstützt.
```

[Öffnen Sie diese Dateien als Overleaf-Projekt.](https://www.overleaf.com/docs?engine=pdflatex\&snip_name\[]=main.tex\&snip\[]=%5Cdocumentclass%7Barticle%7D%0A%5Ctitle%7BUsing+the+markdown+package%7D%0A%5Cusepackage%5BsmartEllipses%5D%7Bmarkdown%7D%0A%5Cbegin%7Bdocument%7D%0A%0A%5CmarkdownInput%7Bexample.md%7D%0A%0A%5Cend%7Bdocument%7D\&snip_name\[]=example.md\&snip\[]=%25%25+example.md%0A%0A%23+I%27m+a+markdown+file.%0A%0AAnd+I+can+do+%2Aemphasis%2A.%0A%23%23+With+sub-headers%0A%0A%3E+Block+quotes+are%0A%3E+written+like+so.%0A%3E%0A%3E+They+can+span+multiple+paragraphs%2C%0A%3E+if+you+like.%0A%0AUse+3+dashes+for+an+em-dash.+Use+2+dashes+for+%0Aranges+%28ex.%2C+%22it%27s+all+in+chapters+12--14%22%29.+%0AThree+dots+...+will+be+converted+to+an+ellipsis+%0A%28provided+you+include+the+smartEllipses+option+%0Ain+your+preamble%29.+Unicode+is+supported.\&main_document=main.tex)

Dieses Beispiel erzeugt die folgende Ausgabe:

![Grafik, die die Ausgabe des markdown-Pakets zeigt](/files/3e0443b2f961ba42b6a712c4194d8ce2691b540d)

## Verwendung von Inline-Markdown

Verwenden Sie die `Markdown` Umgebung verwenden müssen:

```latex
\begin{markdown}
...Ihr Markdown
kommt hierhin...
\end{markdown}
```

um Inline-Markdown zu schreiben, wie das nächste Beispiel zeigt:

```latex
\documentclass{article}
\usepackage[hashEnumerators,smartEllipses]{markdown}
\begin{document}

Verwendung von Inline-Markdown:

\begin{markdown}
Eine h1-Überschrift
============

Absätze werden durch eine Leerzeile getrennt.

2. Absatz. *Kursiv*, **fett** und `Monospace`. Aufzählungslisten
sehen so aus:

* diese hier
* jene hier
* die andere hier

> Blockzitate sind
> so geschrieben.
>
> Sie können mehrere Absätze umfassen,
> wenn Sie möchten.

Eine h2-Überschrift
------------

Hier ist eine nummerierte Liste (verwenden Sie die Option `hashEnumerators`, wenn Sie Hash-Zeichen verwenden möchten):

#. erster Eintrag
#. zweiter Eintrag
#. dritter Eintrag

\end{markdown}
\end{document}
```

[Dieses Beispiel in Overleaf öffnen.](https://www.overleaf.com/docs?engine=pdflatex\&snip_name=Using+markdown\&snip=%5Cdocumentclass%7Barticle%7D%0A%5Cusepackage%5BhashEnumerators%2CsmartEllipses%5D%7Bmarkdown%7D%0A%5Cbegin%7Bdocument%7D%0A%0AUsing+inline+markdown%3A%0A%0A%5Cbegin%7Bmarkdown%7D%0AAn+h1+header%0A%3D%3D%3D%3D%3D%3D%3D%3D%3D%3D%3D%3D%0A%0AParagraphs+are+separated+by+a+blank+line.+%0A%0A2nd+paragraph.+%2AItalic%2A%2C+%2A%2Abold%2A%2A%2C+and+%60monospace%60.+Itemized+lists%0Alook+like%3A%0A%0A%2A+this+one%0A%2A+that+one%0A%2A+the+other+one%0A%0A%3E+Block+quotes+are%0A%3E+written+like+so.%0A%3E%0A%3E+They+can+span+multiple+paragraphs%2C%0A%3E+if+you+like.%0A%0AAn+h2+header%0A------------%0A%0AHere%27s+a+numbered+list+%28use+%60hashEnumerators%60+option+if+you+want+to+use+hashes%29%3A%0A%0A%23.+first+item%0A%23.+second+item%0A%23.+third+item%0A%0A%5Cend%7Bmarkdown%7D%0A%5Cend%7Bdocument%7D)

Dieses Beispiel erzeugt die folgende Ausgabe:

![Beispiel für in Overleaf gesetztes Inline-Markdown](/files/bf96d0ebab39bddf73b34e0a766f69c76cffbcba)

## Funktionen und Optionen des Markdown-Pakets

Hier werden wir einige der [Funktionen und Optionen](https://anorien.csc.warwick.ac.uk/mirrors/CTAN/macros/generic/markdown/markdown.html) des `Markdown` Pakets erkunden.

### Code in Markdown einbinden

Es gibt zwei Möglichkeiten, Codeausschnitte (Codeblöcke) in Markdown darzustellen:

* jede Zeile des Blocks um mindestens vier Leerzeichen oder einen Tab einzurücken, oder
* unter Verwendung sogenannter [abgegrenzter Codeblöcke](#using-fenced-code-blocks)

#### Verwendung von Einrückung zur Darstellung von Codeblöcken

Das folgende Beispiel verwendet 4 oder mehr Leerzeichen am Anfang jeder Codezeile – einige Zeilen verwenden 6, 8 oder 10 Leerzeichen, je nach Größe der erforderlichen Einrückung:

```latex
\documentclass{article}
\usepackage{markdown}
\begin{document}
Hier sind einige Codefragmente, die um mindestens 4 Leerzeichen eingerückt sind.
\vspace{6mm}

\begin{markdown}

Hier ist ein C-Codefragment:

    /* Lassen Sie mich iterieren ... */

    int i;
    for(i=0; i<10; i++)
    {
      do-something(i)
    }

Hier ist etwas HTML:

    <html>
      <head>
        <title>Seitentitel</title>
      </head>
      <body>
        <h1>Dies ist eine Überschrift</h1>
          <p>Dies ist ein Absatz.</p>
      </body>
    </html>

\end{markdown}
\end{document}
```

[Dieses Beispiel in Overleaf öffnen.](https://www.overleaf.com/docs?engine=pdflatex\&snip_name=Using+markdown+code+snippets\&snip=%5Cdocumentclass%7Barticle%7D%0A%5Cusepackage%7Bmarkdown%7D%0A%5Cbegin%7Bdocument%7D%0AHere+are+some+code+fragments+indented+by+at+least+4+space+characters.%0A%5Cvspace%7B6mm%7D%0A%0A%5Cbegin%7Bmarkdown%7D%0A%0AHere+is+a+fragment+of+C%3A%0A%0A++++%2F%2A+Let+me+iterate+...+%2A%2F%0A%0A++++int+i%3B%0A++++for%28i%3D0%3B+i%3C10%3B+i%2B%2B%29%0A++++%7B%0A++++++do-something%28i%29%0A++++%7D%0A%0AHere+is+some+HTML%3A%0A%0A++++%3Chtml%3E%0A++++++%3Chead%3E%0A++++++++%3Ctitle%3EPage+Title%3C%2Ftitle%3E%0A++++++%3C%2Fhead%3E%0A++++++%3Cbody%3E%0A++++++++%3Ch1%3EThis+is+a+Heading%3C%2Fh1%3E%0A++++++++++%3Cp%3EThis+is+a+paragraph.%3C%2Fp%3E%0A++++++%3C%2Fbody%3E%0A++++%3C%2Fhtml%3E%0A%0A%5Cend%7Bmarkdown%7D%0A%5Cend%7Bdocument%7D)

Dieses Beispiel erzeugt die folgende Ausgabe:

![Beispiel für das Setzen von Code via Markdown](/files/7dcc3b08995965b3042bdc12e247fd155edc0b37)

#### Verwendung von abgegrenzten Codeblöcken

Ein abgegrenzter Codeblock wird erzeugt, indem entweder

* drei Backticks (` ``` `), oder
* drei Tilden (`~~~`)

in den Zeilen vor und nach dem Codeblock geschrieben werden. Mit dieser Methode müssen Sie keine Zeilen einrücken, aber Sie müssen die `fencedCode` Option in Ihrer Präambel verwenden:

```latex
\usepackage[fencedCode]{markdown}
```

Hier ist ein Beispiel, das abgegrenzte Codeblöcke mit 3 Backticks (` ``` `):

````latex
\documentclass{article}
\usepackage[fencedCode]{markdown}
\begin{document}
\begin{markdown}

```
if (a > 3) {
    moveShip(5 * gravity, DOWN);
}
```

```
    <html>
      <head>
        <title>Seitentitel</title>
      </head>
      <body>
        <h1>Dies ist eine Überschrift</h1>
          <p>Dies ist ein Absatz.</p>
      </body>
    </html>
```
\end{markdown}
\end{document}
````

[Dieses Beispiel in Overleaf öffnen.](https://www.overleaf.com/docs?engine=pdflatex\&snip_name=Using+markdown+fenced+code+blocks\&snip=%5Cdocumentclass%7Barticle%7D%0A%5Cusepackage%5BfencedCode%5D%7Bmarkdown%7D%0A%5Cbegin%7Bdocument%7D%0A%5Cbegin%7Bmarkdown%7D%0A%0A%60%60%60%0Aif+%28a+%3E+3%29+%7B%0A++++moveShip%285+%2A+gravity%2C+DOWN%29%3B%0A%7D%0A%60%60%60%0A%0A%60%60%60%0A++++%3Chtml%3E%0A++++++%3Chead%3E%0A++++++++%3Ctitle%3EPage+Title%3C%2Ftitle%3E%0A++++++%3C%2Fhead%3E%0A++++++%3Cbody%3E%0A++++++++%3Ch1%3EThis+is+a+Heading%3C%2Fh1%3E%0A++++++++++%3Cp%3EThis+is+a+paragraph.%3C%2Fp%3E%0A++++++%3C%2Fbody%3E%0A++++%3C%2Fhtml%3E%0A%60%60%60%0A%5Cend%7Bmarkdown%7D%0A%5Cend%7Bdocument%7D)

Dieses Beispiel erzeugt die folgende Ausgabe:

![Verwendung abgegrenzter Codeblöcke mit dem markdown-LaTeX-Paket](/files/af894d051203e19090406c7877565c507833a42c)

#### Syntaxhervorhebung

Abgegrenzte Codeblöcke unterstützen Syntaxhervorhebung, indem nach dem ersten Satz von Backticks der Name der Sprache geschrieben wird (`` ` ``). Als Beispiel wird der folgende Block als JavaScript erkannt, indem der erste Satz von Backticks als ` ``` js `:

````latex
``` js
if (a > 3) {
    moveShip(5 * gravity, DOWN);
}
```
````

Für LaTeX kann das `minted` Paket zur Syntaxhervorhebung verwendet werden, wie das nächste Beispiel zeigt, das etwas JavaScript enthält (` ``` js `) und HTML (` ``` html `):

````latex
\documentclass{article}
\usepackage{minted}
\usepackage[fencedCode]{markdown}
\begin{document}
\begin{markdown}

``` js
if (a > 3) {
    moveShip(5 * gravity, DOWN);
}
```

``` html
    <html>
      <head>
        <title>Seitentitel</title>
      </head>
      <body>
        <h1>Dies ist eine Überschrift</h1>
          <p>Dies ist ein Absatz.</p>
      </body>
    </html>
```
\end{markdown}
\end{document}
````

[Dieses Beispiel in Overleaf öffnen.](https://www.overleaf.com/docs?engine=pdflatex\&snip_name=Using+markdown+fenced+code+blocks\&snip=%5Cdocumentclass%7Barticle%7D%0A%5Cusepackage%7Bminted%7D%0A%5Cusepackage%5BfencedCode%5D%7Bmarkdown%7D%0A%5Cbegin%7Bdocument%7D%0A%5Cbegin%7Bmarkdown%7D%0A%0A%60%60%60+js%0Aif+%28a+%3E+3%29+%7B%0A++++moveShip%285+%2A+gravity%2C+DOWN%29%3B%0A%7D%0A%60%60%60%0A%0A%60%60%60+html%0A++++%3Chtml%3E%0A++++++%3Chead%3E%0A++++++++%3Ctitle%3EPage+Title%3C%2Ftitle%3E%0A++++++%3C%2Fhead%3E%0A++++++%3Cbody%3E%0A++++++++%3Ch1%3EThis+is+a+Heading%3C%2Fh1%3E%0A++++++++++%3Cp%3EThis+is+a+paragraph.%3C%2Fp%3E%0A++++++%3C%2Fbody%3E%0A++++%3C%2Fhtml%3E%0A%60%60%60%0A%5Cend%7Bmarkdown%7D%0A%5Cend%7Bdocument%7D)

Dieses Beispiel erzeugt die folgende Ausgabe:

![Syntaxhervorhebung mit minted und Markdown](/files/95ba7739ccbdc942194eda07647a436d1534115d)

### Listen

Die vorherigen Beispiele [zeigen das Erstellen ungeordneter Listen](#using-inline-markdown) in Markdown mit dem `*` Zeichen. Geordnete Listen können mit dem `#` Zeichen erstellt werden, wenn die `hashEnumerators` Option angegeben wurde:

```latex
\usepackage[hashEnumerators]{markdown}
```

Es ist auch möglich, verschachtelte Listen zu erstellen, wie im nächsten Beispiel gezeigt:

```latex
\documentclass{article}
\usepackage[hashEnumerators]{markdown}
\begin{document}
\begin{markdown}
Hier ist eine nummerierte Liste, die eine verschachtelte Liste enthält:

#. Als Erstes besorgen Sie diese Zutaten:

      * Karotten
      * Sellerie
      * Linsen

#. Kochen Sie etwas Wasser.

#. Geben Sie alles in den Topf und folgen Sie diesem Algorithmus:

        Holzlöffel suchen
        Topf aufdecken
        umrühren
        Topf abdecken
        Holzlöffel wackelig auf dem Topfgriff balancieren
        10 Minuten warten
        zur ersten Stufe zurückspringen (oder den Brenner ausschalten, wenn Sie fertig sind)

    Stoßen Sie den Holzlöffel nicht an, sonst fällt er herunter.
\end{markdown}
\end{document}
```

[Dieses Beispiel in Overleaf öffnen.](https://www.overleaf.com/docs?engine=pdflatex\&snip_name=Creating+a+nested+list+in+markdown\&snip=%5Cdocumentclass%7Barticle%7D%0A%5Cusepackage%5BhashEnumerators%5D%7Bmarkdown%7D%0A%5Cbegin%7Bdocument%7D%0A%5Cbegin%7Bmarkdown%7D%0AHere+is+a+numbered+list+that+contains+a+nested+list%3A%0A%0A%23.+First%2C+get+these+ingredients%3A%0A%0A++++++%2A+carrots%0A++++++%2A+celery%0A++++++%2A+lentils%0A%0A%23.+Boil+some+water.%0A%0A%23.+Dump+everything+in+the+pot+and+follow+this+algorithm%3A%0A%0A++++++++find+wooden+spoon%0A++++++++uncover+pot%0A++++++++stir%0A++++++++cover+pot%0A++++++++balance+wooden+spoon+precariously+on+pot+handle%0A++++++++wait+10+minutes%0A++++++++goto+first+step+%28or+shut+off+burner+when+done%29%0A%0A++++Do+not+bump+wooden+spoon+or+it+will+fall.%0A%5Cend%7Bmarkdown%7D%0A%5Cend%7Bdocument%7D)

Dieses Beispiel erzeugt die folgende Ausgabe:

![Nummerierte Listen mit dem LaTeX-Markdown-Paket erstellen](/files/874a8dac3976d8cccd8038a96265e84574e7e8d3)

### LaTeX in Markdown einbinden

Wenn Sie die `hybrid` Option aktivieren, können Sie LaTeX-Code in Markdown mischen!

```latex
\documentclass{article}
\usepackage[hybrid]{markdown}
\begin{document}

\begin{markdown}
Inline-Mathegleichungen können so erstellt werden: $\omega = d\phi / dt$.
Abgesetzte Mathematik kann so geschrieben werden:

\begin{equation}
I = \int \rho R^{2} dV
\end{equation}

\end{markdown}
\end{document}
```

[Dieses Beispiel in Overleaf öffnen.](https://www.overleaf.com/docs?engine=pdflatex\&snip_name=Using+LaTeX+code+in+markdown\&snip=%5Cdocumentclass%7Barticle%7D%0A%5Cusepackage%5Bhybrid%5D%7Bmarkdown%7D%0A%5Cbegin%7Bdocument%7D%0A%0A%5Cbegin%7Bmarkdown%7D%0AInline+math+equations+can+be+created+like+this%3A+%24%5Comega+%3D+d%5Cphi+%2F+dt%24.+%0ADisplay+math+can+be+written+as%3A%0A%0A%5Cbegin%7Bequation%7D%0AI+%3D+%5Cint+%5Crho+R%5E%7B2%7D+dV%0A%5Cend%7Bequation%7D%0A%0A%5Cend%7Bmarkdown%7D%0A%5Cend%7Bdocument%7D)

Dieses Beispiel erzeugt die folgende Ausgabe:

![LaTeX-Code in Markdown verwenden](/files/fda2006e9aa8ea9c96ca6ca7a46e8e960dfa9125)

### Bilder einbinden

* **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
![Alternativtext](Dateiname "Bildunterschrift")
```

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}
![Dies ist Alternativtext, um mein Bild zu beschreiben.](example-image.jpg "Ein Beispielbild, das vom Paket \texttt{mwe} bereitgestellt wird.")
\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:

![Zeigt, wie man Bilder in Markdown importiert](/files/0824dd6f8d89762479ea7dbdea50ee297ce6ffed)

#### 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.

## Weiterführende Lektüre

Overleaf hat weitere Artikel zur Verwendung von Markdown veröffentlicht:

* [Wie man in Markdown auf Overleaf schreibt](/latex/de/ausfuhrliche-artikel/30-how-to-write-in-markdown-on-overleaf.md)
* [Markdown in LaTeX mit Stil](/latex/de/ausfuhrliche-artikel/32-markdown-into-latex-with-style.md)


---

# 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/wissensdatenbank/166-writing-markdown-in-latex-documents.md?ask=<question>&goal=<endgoal>
```

`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.