> 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/32-markdown-into-latex-with-style.md). # Markdownista LaTeXiksi tyylillä **Julkaisun jälkeinen päivitys** (13. toukokuuta 2017): Olemme kiitollisia Vít Novotnýlle, markdown-paketin kirjoittajalle/ylläpitäjälle `markdown` paketista, siitä että hän kirjoitti meille hyödyllistä palautetta alkuperäisestä artikkelista. Meillä on ilo julkaista tämä päivitetty versio, joka ottaa huomioon hänen neuvonsa ja ehdotuksensa ja sisältää ne. ### Johdanto Pysyimme hetken aikaa iloisina [`markdown-paketin`](http://www.ctan.org/pkg/markdown) julkaisusta, joka teki mahdolliseksi kirjoittaa markdown-syntaksia LaTeX-dokumentteihin — ja juhlistimme sitä artikkelilla nimeltä [Kuinka kirjoittaa Markdownilla Overleafissa](/latex/fi/syvalliset-artikkelit/30-how-to-write-in-markdown-on-overleaf.md) jonka tarkoituksena oli näyttää joitakin tuetuista syntakseista. **Muista**: sinun täytyy kääntää `.tex` tiedostosi `--shell-escape` valitsimella, jotta se toimii paikallisissa LaTeX-asennuksissa — Overleaf tekee tämän puolestasi (automaattisesti). Huomaa, että useimmat lehtien lähetysportaalit eivät ota käyttöön `--shell-escape`— ellei sinulla ole oikeutta ladata vain käsikirjoituksesi tulostetta PDF-muodossa, markdownia sisältävät LaTeX-tiedostosi eivät ehkä käänny onnistuneesti kustantajan lähetysjärjestelmässä. Yksi ideoista, joita vihjattiin [aiemmassa artikkelissa](/latex/fi/syvalliset-artikkelit/30-how-to-write-in-markdown-on-overleaf.md) on, että markdownin ja LaTeXin yhdistelmä mahdollistaa sisällön ja tyylin ihastuttavan erottamisen. Tekijöillä (erityisesti niillä, jotka jo tuntevat markdownin) olisi käytössään paljon tiiviimpi syntaksi (eräin varauksin), mutta heillä olisi silti pääsy kaikkiin LaTeX-pakettien ja -mallien hienouksiin, jotka huolehtivat tyylittelystä ja muotoilusta. Se [aiemmassa artikkelissa](/latex/fi/syvalliset-artikkelit/30-how-to-write-in-markdown-on-overleaf.md) antoi joitakin esimerkkejä markdownin käytöstä [Beamer-esityksissä](https://www.overleaf.com/read/dnrwnjrpjjhw) ja [postereissa](https://www.overleaf.com/read/jtbgmmgqrqmh): tänään katsomme vieläkin hauskempia ja jännittävämpiä tyylittelymahdollisuuksia! ### Markdownin käyttäminen tyylitellyissä LaTeX-malleissa Yllä olevien esimerkkien lisäksi voit käyttää markdownia lähes kaikissa malleissa. Tässä on muutama nopea esimerkki: * Se [Legrangen oranssi kirja](https://www.overleaf.com/latex/templates/the-legrand-orange-book-template-english/jtctyfmnpppc) pohjana * Se [Tufte-vaikutteinen moniste](https://www.overleaf.com/latex/templates/handout-design-inspired-by-edward-tufte/dtsbhhkvghzz) pohjana * Tämä [erittäin mukava artikkelipohja](https://www.overleaf.com/read/xfsrpsmdtqvt) Thiagon Saatat huomata, että kaksi näistä on artikkelipohjia ja yksi on kirjapohja. [`markdown-paketin`](http://www.ctan.org/pkg/markdown) havaitsee, onko `\chapter` komento käytettävissä tietyssä LaTeX-dokumentissa, ja tekee ensimmäisen tason otsikosta `markdown` rivin renderöinnin `\chapter` tai `\section` asianmukaiseksi. ### Todella nopeat monisteet: markdown + pocketmod Siitä lähtien kun kuulin ensimmäisen kerran markdownista, se vaikutti nopealta ja kätevältä tavalta tehdä muistiinpanoja: se heijastaa sitä, miten saattaisin raapustella muistiinpanoja paperilappusille tai tarralapuille — erityisesti lueteltujen ja numeroitujen listojen syntaksin ansiosta. Kun loin ensimmäisen kerran [PocketMod-mallin](https://www.overleaf.com/read/nqbhpnrkskrx) vuonna 2015, kaipasin tapaa kirjoittaa markdownia LaTeXissa, jotta voisin luoda PocketModeja *verrattuna* markdownia, koska se tuntui… sopivalta. Muistiinpanojen kirjaaminen yksinkertaisella syntaksilla pieniin taiteltuihin vihkosiin, mutta kauniilla typografialla — jotkut kutsuvat PocketModeja "zineiksi", koska ne ovat pieniä 8-sivuisia vihkosia, jotka voi tehdä yhdestä A4-arkista. Ja niin se todellakin oli mahdollista! Tämä tekee siitä melko helppoa tuottaa nopeasti [viikoittaisen suunnittelijan pienvihko](https://www.overleaf.com/read/zfzcxygqwqsq) tai pienen [kuvasatukirjan](https://www.overleaf.com/read/rppnsfgnrhsf). Kyllä, tyttäreni viihtyi huvittuneena nähdessään satukirjan, joka oli tehty hänen omista piirroksistaan… no, kokonaisten 10 minuutin ajan! [`markdown-paketin`](http://www.ctan.org/pkg/markdown) voit mukauttaa, miten kukin markdown-syntaksi renderöidään LaTeXiksi, joten määrittelin uudelleen vakiomuotoisen `![](img_file "kuvateksti")` syntaksin laittamaan kuvatekstin kuvatiedoston alle (ilman "Kuva"-etuliitettä tai numerointia), ja lisäsin sitten sivunvaihdon. Tämä tekee kuvasatukirjan tekemisestä vielä helpompaa. Tässä on video, joka näyttää, miten vihkon taittelu tehdään: {% embed url="" %} ### Yksinkertaiset reseptivihkoset Kun ajattelet asiaa, resepti koostuu listoista: ainesosaluettelosta, valmistus- tai kypsennysohjeiden listasta ja ehkä muistiinpanojen listasta (kypsennysaika, annokset jne.). Joten sen sijaan, että kirjoittaisimme näin: ```latex \begin{enumerate} \item Ensiksi tee tämä \item Sitten tee tuo ... \end{enumerate} ``` Arvostaisin varmasti, jos voisin kirjoittaa näin: ``` #. Ensiksi tee tämä #. Sitten tee tuo ``` Ja samoin ainesosien kohdalla: ``` - 2 munaa - ripaus suolaa ``` Joten voimme helposti tuottaa nopean reseptin kirjoittamalla näin: ``` # Munakokkeli Kypsennysaika : 5 minuuttia Annoksia : 1 ## Ainesosat - 4 munaa - 1 tl voita - 1/4 kuppia maitoa - suolaa, pippuria (maun mukaan) ## Ohjeet #. Vatkaa munat, maito... #. Kuumenna voi pannulla... #. ... ``` Hmm, tuo näyttää lupaavalta. Muutama meistä Overleafissa (ja perheemme) osallistui omilla lempinopeilla resepteillään (erinomainen ensikertalaisille kokkaajille), ja minä kyhäsin kasaan (anteeksi sanaleikki) [nopean reseptipohjan](https://www.overleaf.com/read/gscqdhnwzsfg) jonka voit kirjoittaa markdownilla *ja* ja tehdä siitä pienvihkon. [![A recipe booklet produced on Overleaf using markdown](/files/25511767eaaf86a2582320dc5889bd8c2d7cb60f)](https://www.overleaf.com/read/gscqdhnwzsfg) Nyt tulee toinen hauska juttu. Kulissien takana tämä on edelleen LaTeXia, joten voimme jatkaa eri elementtien — otsikkotasojen, luettelomerkkien, fonttien ja niin edelleen — tyylittelyä käyttäen tavallista LaTeXin temppupakkia. Tässä vaiheessa innostuin melkoisesti ja keksin *kolme* "teemaa" `simple-recipe` -luokalle! ### Bonus 1: Joitakin varauksia markdown-paketin käytöstä * SyncTeX ei toimi aivan täysin. Overleafissa tämä tarkoittaa, etteivät toiminnot "sijainti esikatselussa" ja "napsauta esikatselussa siirtyäksesi lähteeseen" toimi `markdown` alueilla. * `\\` menettää normaalin merkityksensä: tavallinen "kaksi välilyöntiä ja sitten rivinvaihto" `markdown` temppu ei toimi täällä, koska Lua-jäsennin poistaa loppuvälilyönnit, kuten on dokumentoitu [`markdown` pakettidokumentaatio](http://texdoc.net/pkg/markdown). `\newline` toimii kyllä. * Ole varovainen samalla rivillä olevien useiden alaviivamerkkien kanssa — tästä voi tulla ongelma, jos: * työskentelet yhtälöissäsi monien alaindeksien kanssa (vinkki: poistu `markdown` ympäristöstä tällaisissa tapauksissa); * pidät alaviivojen käytöstä BibTeX-avaimissasi. Voit asettaa `underscores=false` uusimpien `markdown-paketin` tiedostojen kanssa, jotta alaindeksien alaviivat toimivat, mutta se ei silti toimi BibTeX-avainten alaviivojen kanssa. **Päivitys** (13. toukokuuta 2017): Alaviivat BibTeX-avaimissa toimivat `markdown` versiosta v2.5.2 alkaen — kiitos Vít! * Sinulla on jonkin verran vaikeuksia näyttää kirjaimellinen #-merkki, koska edes `\#` ei toimi! Määrittelen yleensä uuden komennon ja käytän sitä sen sijaan. ### Bonus 2: Uudet ominaisuudet päivitetystä markdown-paketista `markdown` v2.4 ja sitä uudemmat lisäsivät tuen joillekin todella hienoille syntakseille: * **Upotettu alaviitesyntaksi**: `...^[tämä on alaviite]` (edellyttää `inlineFootnotes` valitsinta) * **Viitteet:**`[@smith1990]` (edellyttää `viitteet` valitsin; varo myös BibTeX-avainten alaviivoja!) * **Kehystetty koodi**: Voit käyttää joko tildemerkkejä `~` tai backtickejä `` ` `` kehysteenä. ``` ~~~~ int main() { cout << "Hello world!"; return 0; } ~~~~ ``` Jos haluat käyttää näitä uusia ominaisuuksia, muista ladata projektisi päivitetyt versiot tiedostoista `markdown.lua`, `markdown.tex` ja `markdown.sty` projektiisi — tai voit vain luoda uuden projektin [tästä mallista](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/fi/syvalliset-artikkelit/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.