> 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/syvalliset-artikkelit/30-how-to-write-in-markdown-on-overleaf.md).
# Kuinka kirjoittaa Markdownilla Overleafissa
**Julkaisun jälkeinen päivitys** (lisätty 13. toukokuuta 2017): Olemme kiitollisia Vít Novotnỳlle, paketin kirjoittajalle/ylläpitäjälle `markdown` sillä hän kirjoitti meille hyödyllistä palautetta alkuperäisestä artikkelista. Olemme iloisia voidessamme julkaista tämän päivitetyn version, joka ottaa hänen neuvonsa ja ehdotuksensa huomioon ja sisältää ne.
### Häh, mitä?
[Markdown](https://kirkstrobeck.github.io/whatismarkdown.com/) on kevyt merkintäkieli (huomasitko? 😉), jonka avulla voit kirjoittaa jotain pelkkänä tekstinä eräillä *erittäin* yksinkertaisilla säännöillä ja muuntaa sen sitten muotoilluiksi tuloksiksi, esim. HTML:ksi. Se on erittäin suosittu ohjelmistokehittäjien ja ohjelmoijien keskuudessa juuri yksinkertaisuutensa vuoksi (ja voisin lisätä, että se sopii täydellisesti myös muistiinpanojen tekemiseen!).
Esimerkiksi nopean ostoslistan kirjoittamiseksi:
```
# Ostoslista
*Muista* napata niin paljon kuin voimme tulevien [alennusmyyntien](http://acme-marg.com) aikana!
## Ruoka
- uunipavut
- spagetti
## Toimistotarvikkeet
- kirjoituslehtiö
- lyijykynät
```
Ja saat HTML-tulosteen käyttämällä esimerkiksi työkalua kuten [pandoc](http://pandoc.org/):
```html
Ostoslista
Muista napata niin paljon kuin voimme tulevien alennusmyyntien aikana!
Ruoka
Toimistotarvikkeet
- kirjoituslehtiö
- lyijykynät
```
Mukavaa ja yksinkertaista! Voit löytää muuta Markdown-syntaksia [täällä](https://daringfireball.net/projects/markdown/syntax).
### Mitä tämä tarkoittaa minulle?
Monet LaTeX-käyttäjät ovat tyytyväisiä kauniisiin LaTeXilla ladottuihin asiakirjoihinsa, mutta eivät voi olla tuntematta pientä kateuden pistosta Markdown-käyttäjiä kohtaan — koska no, LaTeXin merkintä *voidaan* saattaa toisinaan muuttua varsin monisanaiseksi. Kyllä, listat, teitä katsomme *teitä*...
Hyvä uutinen on, että loistava uusi [`markdown` LaTeX-paketti](https://ctan.org/pkg/markdown) sallii sinun kirjoittaa markdown-syntaksia LaTeX-asiakirjoihisi (eli yksinkertaisempia syötteitä) ja silti saada kauniisti ladottuja PDF:iä! Sinun tarvitsee vain ladata `markdown` paketti asiakirjaasi ja ympäröi Markdown-materiaalisi `markdown` ympäristöä:
```latex
\documentclass{article}
\usepackage{markdown}
\begin{document}
\begin{markdown}
# Ostoslista
*Muista* napata niin paljon kuin voimme tulevien [alennusmyyntien](http://acme-marg.com) aikana!
## Ruoka
- uunipavut
- spagetti
## Toimistotarvikkeet
- kirjoituslehtiö
- lyijykynät
\end{markdown}
\end{document}
```
Tai jos haluat mieluummin laittaa Markdown-materiaalisi tiedostoon `*.md` tiedostoon:
```latex
\documentclass{article}
\usepackage{markdown}
\begin{document}
\markdownInput{example.md}
\end{document}
```
Siistiä! Tämä tekee todennäköisesti kehittäjätyypit erittäin onnellisiksi, koska he voivat nyt vain kopioida suoraan heidän `.md` dokumentaationsa!
### Voinko silti käyttää LaTeX-komentoja, jos kirjoitan Markdownia?
Kyllä, voit silti käyttää LaTeX-komentoja Markdown-materiaalissasi! Anna vain `hybrid` -asetukseksi `markdown`:
```latex
\usepackage[hybrid]{markdown}
...
- kirjoituslehtiö (sellainen, jonka kannessa on suuri $E=mc^2$)
```
### Miten voin käyttää kirjaimellisia merkkejä kuten '#' ja '\_' (alaviivoja)?
#### Kirjoitettaessa '#'-merkkiä
Et voi kirjoittaa '#' -merkkiä *sisällä `markdown` ympäristössä*. Edes `\#` toimiakseen. Sinun täytyy määritellä komento kuten `\newcommand{\texthash}{\#}`, ja sitten käyttää `\texthash` sinun `markdown` ympäristössä. Sama koskee alaviivoja, erityisesti kun samalla rivillä on enemmän kuin yksi, esim. `$y = m_1 + n_2$`. Joskus voi olla helpompaa päättää nykyinen `markdown` ympäristö ja kirjoittaa ongelmalliset rivit tavallisessa LaTeX-tilassa, ja sitten aloittaa toinen `markdown` ympäristössä.
#### Kirjoitettaessa '\_' (alaviivaa) ja '\`' (backtick)
**Päivitys** (lisätty 13. toukokuuta 2017): Koska `markdown` versiosta 2.5 alkaen voit asettaa `underscores = false` ja `codeSpans = false` poistaaksesi alaviivat ja backtickit käytöstä. Tämä tekee mahdolliseksi kirjoittaa matematiikan alaindeksit ja lainausmerkit hybriditilassa ilman eskapointia. Meillä on asteriskit korostusta varten, joten ainoa todella menetetty asia ovat rivinsisäiset koodiesimerkit. Kiitos Vít vinkistä!
#### Vältettävät ympäristöt...
Ja vaikka voit käyttää backtickejä kirjoittaaksesi rivinsisäistä sellaisenaan tekstiä tai sisentää rivin neljällä välilyönnillä saadaksesi sellaisenaan tekstilohkon, älä käytä `lstlisting` eikä `minted` LaTeX-ympäristöjä `markdown` ympäristöjen sisällä. Älä vain.
#### HTML:n käyttäminen markdown-ympäristössä
Ja ei, et voi käyttää HTML:ää LaTeX- `markdown` ympäristön sisällä (vaikka tämä onkin tavallisessa Markdownissa yleistä). Pahoittelut.
**Päivitys** (lisätty 13. toukokuuta 2017): Versiosta `markdown` v2.3:ssa on `html` valinta, joka ei näytä HTML-tageja sellaisenaan, jos niitä on markdown-materiaalissasi, vaikka se ei oikeastaan muotoile tagien sisältöäkään — eli `Hei!` näyttää vain Hei! normaalilla fonttipainolla. Mutta HTML-entiteetit kuten `©` renderöidään merkkinä ©. Kiitos Vítille tämän huomauttamisesta.
### Suositellut markdown-paketin asetukset
Yksi joukko `markdown` paketin asetuksia, joista voi olla hyötyä, on:
```latex
\usepackage[footnotes,definitionLists,hashEnumerators,smartEllipses,hybrid]{markdown}
```
Nämä asetukset mahdollistavat
* alaviitteiden Markdown-syntaksin käytön (kuten `[^1]`);
* määritelmäluettelot ja `#` numeroiduille listoille;
* "oikeat" ellipsit (…).
Tässä on [täydellinen esimerkki](https://www.overleaf.com/latex/examples/using-markdown-in-latex-documents/whdrnpcpnwrm) Overleafin galleriassa, ja tässä on [toinen](https://www.overleaf.com/articles/how-to-write-using-rich-text-format-and-markdown-in-latex-and-overleaf/dbqrxvftzskw).
### Hyperlinkit ja alaviitteet: miten?
Overleaf-esimerkissä hyperlinkki on alaviite. Miten saan siitä hyperref-hyperlinkin?
`markdown` on muokattavissa, joten voit määritellä, miten haluat eri elementtien renderöitävän. Näiden lisääminen johdantoosi tekee juuri niin:
```latex
\markdownSetup{renderers={
link = {\href{#2}{#1}}
}}
```
**Päivitys** (lisätty 13. toukokuuta 2017): `rendererPrototypes` käytettiin alkuperäisessä versiossa. Tavallisille käyttäjille suositellaan käyttämään `renderers` omia määrittelyjään varten, sillä `rendererPrototypes` on tarkoitettu pakettien tekijöille oletusarvojen tarjoamiseen. Jos muokkaat `rendererPrototypes`, olet vaarassa, että jokin toinen paketti ohittaa asetuksesi. Kiitos Vítille tämän huomauttamisesta!
### Kuvien sisällyttäminen (päivitetty 8. marraskuuta 2022)
* **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
```
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}
\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:
#### 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.
#### Kelluvien objektien sijoittelutunnisteiden muuttaminen (edistyneempi)
Markdownin kuvien lisäämisen syntaksi ei salli sinun määrittää kelluvien objektien sijoittelutunnisteita suoraan, mutta voit säätää niitä määrittelemällä uudelleen, miten kuva renderöidään:
```latex
\markdownSetup{renderers={
image = {\begin{figure}[hbt!]
\centering
\includegraphics{#3}%
\ifx\empty#4\empty\else
\caption{#4}%
\fi
\end{figure}}
}}
```
Lisätietoja varten katso [markdownin dokumentaatiota](https://mirror.apps.cam.ac.uk/pub/tex-archive/macros/generic/markdown/markdown.html).
### Voiko taulukoita luoda käyttämällä Markdownia LaTeXissa? 😀
Valitettavasti ei. Taulukoita tuetaan vain [MultiMarkdownissa](http://fletcherpenney.net/multimarkdown/) ja LaTeX `markdown` paketti ei tällä hetkellä tue sitä.
**Päivitys** (lisätty 13. toukokuuta 2017): Vítin vinkin perusteella on mahdollista käyttää `contentBlocks` syntaksilaajennusta versiosta 2.4 alkaen, tai säätää `inputFencedCode` rendereriä, jotta osa CSV-tyylisestä tekstistä saadaan nopeasti taulukoksi.
### Lisää markdown-paketin herkkuja...?
Kuten aiemmin mainittiin, se on kätevä tapa tehdä muistiinpanoja, ja yhdistettynä joihinkin hienoihin LaTeX-asiakirjaluokkiin tai pakettiasetuksiin sen avulla saat kauniin muistikirjan jo luennon aikana. Esimerkiksi voisit käyttää sitä [Tufte-asiakirjaluokkien](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}
```
Ja lyhyt ja yksinkertainen syntaksi, joka tekee listojen kirjoittamisesta paljon kätevämpää, tarkoittaa, että meillä on nyt *todella nopea* tapa kirjoittaa [Beamer-esityksiä](https://www.overleaf.com/latex/examples/writing-beamer-slides-with-markdown/dnrwnjrpjjhw) ja [julisteita](https://www.overleaf.com/latex/examples/writing-beamer-slides-with-markdown/dnrwnjrpjjhw)!
Pidä hauskaa!
---
# 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/syvalliset-artikkelit/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.