> 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/no/dybdeartikler/32-markdown-into-latex-with-style.md). # Markdown til LaTeX med stil **Oppdatering etter publisering** (13. mai 2017): Vi er takknemlige overfor Vít Novotný, forfatteren/vedlikeholderen av `markdown` pakken, for at han skrev til oss med noen nyttige tilbakemeldinger om den opprinnelige artikkelen. Vi er glade for å publisere denne oppdaterte versjonen som tar hensyn til, og inkluderer, hans råd og forslag. ### Innledning For en stund siden gledet vi oss over lanseringen av [`markdown-pakken`](http://www.ctan.org/pkg/markdown) som gjorde det mulig å skrive markdown-syntaks i LaTeX-dokumenter – og feiret det med en artikkel kalt [Slik skriver du i Markdown på Overleaf](/latex/no/dybdeartikler/30-how-to-write-in-markdown-on-overleaf.md) hvis formål var å demonstrere noe av den støttede syntaksen. **Husk**: Du må kompilere `.tex` filene dine med `--shell-escape` -alternativet for å få det til å fungere på lokale LaTeX-installasjoner – Overleaf gjør dette for deg (automatisk). Husk at de fleste innleveringsportaler for tidsskrifter ikke aktiverer `--shell-escape`– med mindre du bare får lov til å laste opp PDF-uttaket av manuskriptet ditt, kan LaTeX-filene dine som inneholder markdown, hende de ikke kompileres vellykket når de behandles av forlagets innsendingssystem. En av ideene som antydes i den [tidligere artikkelen](/latex/no/dybdeartikler/30-how-to-write-in-markdown-on-overleaf.md) er at en kombinasjon av markdown og LaTeX gir en fantastisk adskillelse av innhold og stil. Forfattere (særlig de som allerede er kjent med markdown) ville ha en langt mer konsis syntaks å arbeide med (med noen forbehold), samtidig som de fortsatt har tilgang til alle gledene ved LaTeX-pakker og -maler til å ta seg av stilsetting og formatering. Det [tidligere artikkelen](/latex/no/dybdeartikler/30-how-to-write-in-markdown-on-overleaf.md) ga noen eksempler på bruk av markdown i [Beamer-presentasjoner](https://www.overleaf.com/read/dnrwnjrpjjhw) og [plakater](https://www.overleaf.com/read/jtbgmmgqrqmh): i dag skal vi se på enda flere morsomme og spennende stilingsmuligheter! ### Bruk av markdown i stiliserte LaTeX-maler Bortsett fra eksemplene ovenfor kan du bruke markdown i nesten alle maler. Her er noen raske eksempler: * Den [Legrange orange book](https://www.overleaf.com/latex/templates/the-legrand-orange-book-template-english/jtctyfmnpppc) mal * Den [Tufte-inspirert utdelingsark](https://www.overleaf.com/latex/templates/handout-design-inspired-by-edward-tufte/dtsbhhkvghzz) mal * Denne [veldig fin artikkelmal](https://www.overleaf.com/read/xfsrpsmdtqvt) av Thiago Du vil kanskje legge merke til at to av disse er artikkelmaler og én er en bokmal. Den [`markdown-pakken`](http://www.ctan.org/pkg/markdown) registrerer om `\chapter` kommandoen er tilgjengelig for bruk i et bestemt LaTeX-dokument og vil gjøre toppnivåoverskriften `markdown` linjen gjengitt som `\chapter` eller `\section` som passende. ### Virkelig raske utdelingsark: markdown + pocketmod Siden jeg først lærte om markdown, oppfattet jeg det som en rask og praktisk måte å ta notater på: det gjenspeiler hvordan jeg kanskje ville skrible ned notater på papirlapper eller post-it-lapper – særlig med syntaksen for punktlister og nummererte lister. Da jeg først laget [PocketMod-mal](https://www.overleaf.com/read/nqbhpnrkskrx) i 2015, ønsket jeg meg en måte å skrive markdown i LaTeX på, slik at jeg kunne lage PocketMods *med* markdown fordi det føltes … passende. Å notere ned i en enkel syntaks på små foldede hefter, men med pen typografi – noen omtaler PocketMods som "zines" fordi de er små 8-siders hefter som du kan lage av ett enkelt ark A4-papir. Og så var det faktisk mulig! Dette gjør det ganske enkelt å raskt lage en [liten ukesplanlegger](https://www.overleaf.com/read/zfzcxygqwqsq) eller en liten [bildebok](https://www.overleaf.com/read/rppnsfgnrhsf). Ja, det moret datteren min å se en bildebok laget av hennes egne tegninger … vel, i hele 10 minutter! Den [`markdown-pakken`](http://www.ctan.org/pkg/markdown) lar deg tilpasse hvordan hver markdown-syntaks gjengis i LaTeX, så jeg omdefinerte standard `![](img_file "caption")` syntaksen til å plassere bildeteksten under bildefilen (uten noe prefiks "Figure" eller nummerering), og deretter satte jeg inn et sideskift. Dette gjør det enda enklere å lage bildeboken. Her er en video som viser hvordan man bretter heftet: {% embed url="" %} ### Enkle oppskriftshefter Når du tenker over det, består en oppskrift av lister: en liste over ingredienser, en liste over tilberednings- eller matlagingsinstruksjoner, og kanskje en liste med notater (tilberedningstid, antall porsjoner osv.). Så i stedet for å skrive dette: ```latex \begin{enumerate} \item Først gjør dette \item Deretter gjør dette ... \end{enumerate} ``` Jeg ville definitivt sette pris på å kunne skrive dette: ``` #. Først gjør dette #. Deretter gjør dette ``` Og tilsvarende for ingrediensene: ``` - 2 egg - en klype salt ``` Så for enkelt å lage en rask oppskrift kan vi skrive dette: ``` # Eggerøre Tilberedningstid : 5 minutter Gir : 1 ## Ingredienser - 4 egg - 1 ts smør - 1/4 kopp melk - salt, pepper (etter smak) ## Instruksjoner #. Visp egg, melk... #. Varm smøret i pannen... #. ... ``` Hmm, det ser lovende ut. Noen av oss i Overleaf (og familiene våre) bidro med favorittoppskriftene våre for raske retter (ideelle for nybegynnere) og jeg snekret sammen (unnskyld ordspillet) en [mal for raske oppskrifter](https://www.overleaf.com/read/gscqdhnwzsfg) som du kan skrive med markdown *og* gjøre om til et lite hefte. [![A recipe booklet produced on Overleaf using markdown](/files/4a118f8b2c48c96e8bbf5c5d3dbe2e6a4906b717)](https://www.overleaf.com/read/gscqdhnwzsfg) Nå kommer enda litt moro. Bak kulissene er dette fortsatt LaTeX, så vi kan fortsette å stilsette de ulike elementene – seksjonsoverskrifter, punktlister, skrifttyper og så videre – ved hjelp av den vanlige LaTeX-verktøykassen. Det var da jeg lot meg rive med og kom opp med *tre* «temaer» for `simple-recipe` klassen! ### Bonus 1: Noen forbehold ved bruk av markdown-pakken * SyncTeX vil ikke helt fungere. I Overleaf betyr dette at operasjonene «posisjon i forhåndsvisning» og «klikk i forhåndsvisningen for å hoppe til kilden» ikke vil fungere i `markdown` områdene. * `\\` mister sin vanlige betydning: det vanlige "to mellomrom etterfulgt av en ny linje" `markdown` trikset fungerer ikke her fordi etterfølgende mellomrom fjernes av Lua-parseren, slik det er dokumentert i [`markdown` pakkedokumentasjon](http://texdoc.net/pkg/markdown). `\newline` vil fungere, derimot. * Vær forsiktig med flere understreker-tegn på samme linje – dette kan være et problem hvis: * du arbeider med mange senkede indekser i ligningene dine (tips: gå ut av `markdown` miljøet i slike tilfeller); * du liker å bruke understrek i BibTeX-nøklene dine. Du kan sette `underscores=false` med de nyeste `markdown-pakken` filene for å få understrek i senkede indekser til å fungere, men det vil fortsatt ikke fungere med understrek i BibTeX-nøkler. **Oppdatering** (13. mai 2017): Understreker i BibTeX-nøkler vil fungere med `markdown` v2.5.2 og nyere – takk, Vít! * Du vil få noen vanskeligheter med å vise tegnet # bokstavelig, fordi ikke engang `\#` vil fungere! Jeg definerer vanligvis en ny kommando og bruker den i stedet. ### Bonus 2: Nye funksjoner i den oppdaterte markdown-pakken `markdown` v2.4 og nyere la til støtte for noe virkelig fin syntaks: * **Innebygd fotnotesyntaks**: `...^[dette er fotnoten]` (krever `inlineFootnotes` -alternativet) * **Siteringer:**`[@smith1990]` (krever `siteringer` -alternativet; vær også oppmerksom på understreker i BibTeX-nøklene dine!) * **Avgrenset kode**: Du kan bruke enten tilder `~` eller backticks `` ` `` som avgrensningen. ``` ~~~~ int main() { cout << "Hello world!"; return 0; } ~~~~ ``` Hvis du vil bruke disse nye funksjonene, må du sørge for å laste opp oppdaterte versjoner av `markdown.lua`, `markdown.tex` og `markdown.sty` til prosjektet ditt – eller du kan bare opprette et nytt prosjekt fra [denne malen](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/no/dybdeartikler/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.