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

# Markdownin kirjoittaminen LaTeX-asiakirjoissa

## Johdanto

Jotta voit käyttää markdownia LaTeX-dokumentissa, sinun täytyy ladata [`markdown` paketti](https://www.ctan.org/pkg/markdown) dokumenttisi johdantoon:

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

jossa `[settings]` on *valinnainen* asetusten joukko, jota käytetään tiettyjen pakettiominaisuuksien määrittämiseen tai ottamiseen käyttöön. Katso `markdown` paketti [dokumentaatiota](https://anorien.csc.warwick.ac.uk/mirrors/CTAN/macros/generic/markdown/markdown.html) saadaksesi [kuvauksen paketin parametreista (asetuksista)](https://anorien.csc.warwick.ac.uk/mirrors/CTAN/macros/generic/markdown/markdown.html#options).

Tässä artikkelissa käydään lyhyesti läpi sekä *sulautettuun* dokumenttisi sisällä kirjoitettua markdownia — sekä tuomista *external* tekstitiedostossa olevaa markdownia.

* **Huomautus**: Yleisesti ottaen markdownin käyttöä LaTeX-dokumentin sisällä tulisi pitää täydentävänä ja kätevänä vaihtoehtona joidenkin dokumenttisi sisältöelementtien kirjoittamiseen, ei vaihtoehtoisena syntaksina, joka korvaisi LaTeXin kokonaan.

## Ulkoisten markdown-tiedostojen käyttäminen

Käytä komentoa

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

sisällyttääksesi markdown-tiedoston `filename`.

Seuraava esimerkki lisää tiedoston nimeltä `example.md`. Käytä alla olevaa linkkiä koodilistauksien alla avataksesi ne Overleaf-projektina:

**`main.tex`**

```latex
\documentclass{article}
\title{markdown-paketin käyttäminen}
\usepackage[smartEllipses]{markdown}
\begin{document}

\markdownInput{example.md}

\end{document}
```

**`example.md`**

```latex
%% example.md

# Olen markdown-tiedosto.

Ja voin tehdä *korostusta*.
## Alaotsikoilla

> Lainaukset ovat
> kirjoitettu näin.
>
> Ne voivat ulottua useisiin kappaleisiin,
> jos haluat.

Käytä 3 viivaa ajatusviivaa varten. Käytä 2 viivaa väleihin
(esim. "kaikki on luvuissa 12--14").
Kolme pistettä ... muunnetaan ellipsiksi
(edellyttäen, että sisällytät smartEllipses-asetuksen
johdantoosi). Unicodea tuetaan.
```

[Avaa nämä tiedostot Overleaf-projektina.](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)

Tämä esimerkki tuottaa seuraavan tulosteen:

![Grafiikka, joka näyttää markdown-paketin tulosteen](/files/c1d5fb0fd57601b6a374570953b88316034120b8)

## Rivinsisäisen markdownin käyttäminen

Käytä `markdown` ympäristöä:

```latex
\begin{markdown}
...markdownisi
tulee tähän...
\end{markdown}
```

kirjoittaaksesi rivinsisäistä markdownia, kuten seuraava esimerkki osoittaa:

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

Rivinsisäinen markdown:

\begin{markdown}
H1-otsikko
============

Kappaleet erotetaan tyhjällä rivillä.

2. kappale. *kursiivi*, **lihavoitu** ja `tasavälinen`. Luettelot
näyttävät tältä:

* tämä
* tuo
* toinen

> Lainaukset ovat
> kirjoitettu näin.
>
> Ne voivat ulottua useisiin kappaleisiin,
> jos haluat.

H2-otsikko
------------

Tässä on numeroitu luettelo (käytä `hashEnumerators`-asetusta, jos haluat käyttää risuaitoja):

#. ensimmäinen kohta
#. toinen kohta
#. kolmas kohta

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

[Avaa tämä esimerkki Overleafissa.](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)

Tämä esimerkki tuottaa seuraavan tulosteen:

![Esimerkki rivinsisäisen markdownin ladonnasta Overleafissa](/files/d7401f991ea5769bca90034b37c95e06894e9267)

## Markdown-paketin ominaisuudet ja asetukset

Tässä tutkimme muutamia [ominaisuuksia ja asetuksia](https://anorien.csc.warwick.ac.uk/mirrors/CTAN/macros/generic/markdown/markdown.html) joita tarjoaa `markdown` pakettiin.

### Koodin sisällyttäminen markdowniin

Markdownissa koodikatkelmien (koodilohkojen) näyttämiseen on kaksi tapaa:

* sisentämällä lohkon jokainen rivi vähintään neljällä välilyönnillä tai yhdellä sarkaimella, tai
* käyttämällä niin kutsuttuja [rajattuja koodilohkoja](#using-fenced-code-blocks)

#### Koodilohkojen näyttäminen sisennyksen avulla

Seuraava esimerkki käyttää 4 tai useampaa välilyöntiä kunkin koodirivin alussa — jotkin rivit käyttävät 6, 8 tai 10 välilyöntiä tarvittavan sisennyksen koosta riippuen:

```latex
\documentclass{article}
\usepackage{markdown}
\begin{document}
Tässä on joitakin koodikatkelmia, jotka on sisennetty vähintään 4 välilyönnillä.
\vspace{6mm}

\begin{markdown}

Tässä on C-katkelma:

    /* Anna minun iteroida ... */

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

Tässä on hieman HTML:ää:

    <html>
      <head>
        <title>Page Title</title>
      </head>
      <body>
        <h1>Tämä on otsikko</h1>
          <p>Tämä on kappale.</p>
      </body>
    </html>

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

[Avaa tämä esimerkki Overleafissa.](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)

Tämä esimerkki tuottaa seuraavan tulosteen:

![Esimerkki koodin ladonnasta markdownin avulla](/files/669f39596baa52da4b30ca7af6552676b41616b1)

#### Rajattujen koodilohkojen käyttäminen

Rajattu koodilohko luodaan kirjoittamalla joko

* kolme backtick-merkkiä (` ``` `), tai
* kolme tildeä (`~~~`)

koodilohkon edellä ja jäljessä oleville riveille. Tätä tapaa käyttäessäsi sinun ei tarvitse sisentää rivejä, mutta sinun täytyy käyttää `fencedCode` asetusta johdannossasi:

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

Tässä on esimerkki rajattujen koodilohkojen luomisesta käyttäen 3 backtick-merkkiä (` ``` `):

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

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

```
    <html>
      <head>
        <title>Page Title</title>
      </head>
      <body>
        <h1>Tämä on otsikko</h1>
          <p>Tämä on kappale.</p>
      </body>
    </html>
```
\end{markdown}
\end{document}
````

[Avaa tämä esimerkki Overleafissa.](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)

Tämä esimerkki tuottaa seuraavan tulosteen:

![Rajattujen koodilohkojen käyttäminen markdown LaTeX -paketilla](/files/2826a7e16d2cd2d2b7419c34cde53995dfb2a0e2)

#### Syntaksin korostus

Rajatut koodilohkot tukevat syntaksin korostusta, kun kielen nimi kirjoitetaan ensimmäisen backtick-sarjan jälkeen (`` ` ``). Esimerkiksi seuraava lohko tunnistetaan Javascriptiksi kirjoittamalla ensimmäinen backtick-sarja muodossa ` ``` js `:

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

LaTeXissa `minted` pakettia voidaan käyttää syntaksin korostukseen, kuten seuraavassa esimerkissä, joka sisältää hieman Javascriptiä (` ``` js `) ja 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>Page Title</title>
      </head>
      <body>
        <h1>Tämä on otsikko</h1>
          <p>Tämä on kappale.</p>
      </body>
    </html>
```
\end{markdown}
\end{document}
````

[Avaa tämä esimerkki Overleafissa.](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)

Tämä esimerkki tuottaa seuraavan tulosteen:

![Syntaksin korostus mintedin ja markdownin avulla](/files/f37f7ebb7deb40dbd395d30108a5dabdf800c63f)

### Luettelot

Edelliset esimerkit [osoittavat järjestämättömien luetteloiden luomista](#using-inline-markdown) markdownissa käyttäen `*` merkkiä. Järjestetyt luettelot voidaan luoda käyttämällä `#` merkkiä, jos `hashEnumerators` asetus on määritetty:

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

On myös mahdollista luoda sisäkkäisiä luetteloita, kuten seuraava esimerkki osoittaa:

```latex
\documentclass{article}
\usepackage[hashEnumerators]{markdown}
\begin{document}
\begin{markdown}
Tässä on numeroitu luettelo, joka sisältää sisäkkäisen luettelon:

#. Ensin hanki nämä ainekset:

      * porkkanat
      * selleri
      * linssit

#. Keitä vettä.

#. Kaada kaikki kattilaan ja seuraa tätä algoritmia:

        etsi puulusikka
        avaa kattila
        sekoita
        peitä kattila
        tasapainota puulusikka varovasti kattilan kahvan päälle
        odota 10 minuuttia
        siirry ensimmäiseen vaiheeseen (tai sammuta liesi, kun olet valmis)

    Älä töni puulusikkaa, tai se putoaa.
\end{markdown}
\end{document}
```

[Avaa tämä esimerkki Overleafissa.](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)

Tämä esimerkki tuottaa seuraavan tulosteen:

![Numeroitujen luetteloiden luominen LaTeX-markdown-paketilla](/files/74f8925a6babc7b24c9c7152d76f416f81e357c4)

### LaTeX-koodin käyttäminen markdownissa

Jos otat käyttöön `hybrid` asetuksen, voit sekoittaa LaTeX-koodia Markdowniin!

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

\begin{markdown}
Rivinsisäisiä matemaattisia yhtälöitä voidaan luoda näin: $\omega = d\phi / dt$.
Esitettävä matematiikka voidaan kirjoittaa näin:

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

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

[Avaa tämä esimerkki Overleafissa.](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)

Tämä esimerkki tuottaa seuraavan tulosteen:

![LaTeX-koodin käyttäminen markdownissa](/files/a292ff88e7488df718a7ba337ce6c1dba5e668f2)

### Kuvien sisällyttäminen

* **Huomaa**: Seuraava esimerkki käyttää grafiikkatiedostoa (`example-image.pdf`) jonka tarjoaa `mwe` paketti. Nämä grafiikkatiedostot jaetaan TeX Liven mukana ja tallennetaan siten Overleafin palvelimille, jolloin ne ovat saatavilla kuvapaikkamerkkeinä, kuten alla olevassa esimerkissä.

Kuvia voidaan sisällyttää markdowniin kirjoittamalla seuraavan muotoinen merkintä:

```latex
![alt-teksti](tiedostonimi "kuvateksti")
```

Toivottavasti parametrien nimet `alt-teksti`, `tiedostonimi` ja `"kuvateksti"` kertovat, mitä ne tekevät. Tässä on esimerkki niiden havainnollistamiseksi:

```latex
\documentclass{article}
\usepackage[hybrid]{markdown}
% mwe-paketti tarjoaa esimerkkikuvia. Sen lataaminen on
% ei välttämätöntä, koska nuo kuvat ovat LaTeXin hakupolulla.
% Tässä lataamme sen selkeyden vuoksi tässä esimerkissä.
\usepackage{mwe}
\begin{document}
\begin{markdown}
Tämä esimerkki näyttää, miten grafiikkatiedosto tuodaan. Tässä käytämme
`mwe`-paketin tarjoamaa esimerkkikuvaa.

% Käytä \setkeys{Gin}-komentoa, jos sinun täytyy muuttaa kuvan näyttökokoa

\setkeys{Gin}{width=.5\linewidth}
![Tämä on vaihtoehtoinen teksti kuvan kuvaamiseksi.](example-image.jpg "mwe-paketin tarjoama esimerkkikuva.")
\end{markdown}
\end{document}
```

[Avaa tämä esimerkki Overleafissa.](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)

Tämä esimerkki tuottaa seuraavan tulosteen:

![Näytetään, miten kuvia tuodaan markdownissa](/files/848618453c22a2bd07d0b24d9f0ec3e6e78cd303)

#### Huomio kuvan leveydestä

Kuten useimmat paketit, `markdown` lataa muita paketteja, mukaan lukien [`keyval`](https://ctan.org/pkg/keyval?lang=en) ja [`graphicx`](https://ctan.org/pkg/graphicx?lang=en), jotta voidaan hyödyntää niiden tarjoamia komentoja ja ominaisuuksia. Tässä kuvan leveys asetetaan käyttämällä `\setkeys` -komentoa, jonka tarjoaa `keyvals`. `Gin` on "avainperhe", jonka määrittelee `graphicx` pakettiin.

* **Huomaa**: Koska LaTeX-komentoa, tässä `\setkeys`, käytetään *sisällä* sivustolta `markdown` ympäristössä,  `hybrid` markdown-paketin asetus on pakollinen.

## Lisälukemista

Overleaf on julkaissut muita artikkeleita markdownin käytöstä:

* [Kuinka kirjoittaa Markdownia Overleafissa](/latex/fi/syvalliset-artikkelit/30-how-to-write-in-markdown-on-overleaf.md)
* [Markdownista LaTeXin tyyliin](/latex/fi/syvalliset-artikkelit/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/fi/tietopankki/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.