> 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/da/dybtgaende-artikler/32-markdown-into-latex-with-style.md).

# Markdown til LaTeX med stil

**Opdatering efter udgivelsen** (13. maj 2017): Vi er taknemmelige over for Vít Novotný, forfatteren/vedligeholderen af `markdown` pakken, for at skrive til os med noget nyttig feedback vedrørende den oprindelige artikel. Vi er glade for at kunne udgive denne opdaterede version, som tager hans råd og forslag til efterretning og inkluderer dem.

### Introduktion

For noget tid siden jublede vi over udgivelsen af [`markdown-pakken`](http://www.ctan.org/pkg/markdown) som gjorde det muligt at skrive markdown-syntaks i LaTeX-dokumenter — og fejrede det med en artikel kaldet [Sådan skriver du i Markdown på Overleaf](/latex/da/dybtgaende-artikler/30-how-to-write-in-markdown-on-overleaf.md) hvis formål var at demonstrere noget af den understøttede syntaks.

**Husk**: Du skal kompilere dine `.tex` filer med `--shell-escape` -indstillingen for at få det til at virke på lokale LaTeX-installationer — Overleaf gør det automatisk for dig. Vær opmærksom på, at de fleste portaler til indsendelse af artikler ikke aktiverer `--shell-escape`—medmindre du kun har tilladelse til at uploade den endelige PDF af dit manuskript, kan dine LaTeX-filer, der indeholder markdown, muligvis ikke kompilere korrekt, når de behandles af forlagets indsendelsessystem.

En af de idéer, der blev antydet i den [tidligere artikel](/latex/da/dybtgaende-artikler/30-how-to-write-in-markdown-on-overleaf.md) er, at en kombination af markdown og LaTeX giver en vidunderlig adskillelse af indhold og stil. Forfattere (især dem, der allerede er fortrolige med markdown) ville have en langt mere kortfattet syntaks at arbejde med (med visse forbehold), samtidig med at de stadig har adgang til alle LaTeX-pakkernes og -skabelonernes herligheder til at tage sig af stil og formatering. Det [tidligere artikel](/latex/da/dybtgaende-artikler/30-how-to-write-in-markdown-on-overleaf.md) gav nogle eksempler på brug af markdown i [Beamer-præsentationer](https://www.overleaf.com/read/dnrwnjrpjjhw) og [plakater](https://www.overleaf.com/read/jtbgmmgqrqmh): i dag skal vi se på endnu flere sjove og spændende stylingsmuligheder!

### Brug af markdown i styled LaTeX-skabeloner

Bortset fra eksemplerne ovenfor kan du bruge markdown i næsten alle skabeloner. Her er et par hurtige eksempler:

* Den [Legrange orange bog](https://www.overleaf.com/latex/templates/the-legrand-orange-book-template-english/jtctyfmnpppc) skabelon
* Den [Tufte-inspireret uddelingsark](https://www.overleaf.com/latex/templates/handout-design-inspired-by-edward-tufte/dtsbhhkvghzz) skabelon
* Denne [meget flot artikel-skabelon](https://www.overleaf.com/read/xfsrpsmdtqvt) af Thiago

Du bemærker måske, at to af disse er artikelskabeloner, og en er en bogskabelon.  [`markdown-pakken`](http://www.ctan.org/pkg/markdown) registrerer, om `\chapter` -kommandoen er tilgængelig til brug i et bestemt LaTeX-dokument og vil få overskriften på første niveau `markdown` linjen til at gengives som `\chapter` eller `\section` som passende.

### Virkelig hurtige uddelingsark: markdown + pocketmod

Siden jeg første gang lærte markdown at kende, slog det mig som en hurtig og bekvem måde at tage noter på: det afspejler, hvordan jeg måske ville skrible noter ned på papirlapper eller post-it-sedler — især med syntaksen for punkt- og nummererede lister. Da jeg første gang oprettede [PocketMod-skabelonen](https://www.overleaf.com/read/nqbhpnrkskrx) i 2015, længtes jeg efter en måde at skrive markdown i LaTeX på, så jeg kunne lave PocketMods *med* markdown, fordi det virkede… passende. At skrive noter ned i en enkel syntaks på små foldede hæfter, men med flot typografi — nogle kalder PocketMods for "zines", fordi de er små hæfter på 8 sider, som du kan lave ud af ét enkelt ark A4-papir.

Og det var det faktisk muligt! Det gør det ret nemt hurtigt at lave en [mini-hæfte til ugentlig planlægning](https://www.overleaf.com/read/zfzcxygqwqsq) eller en lille [billedbog](https://www.overleaf.com/read/rppnsfgnrhsf). Ja, det underholdt min datter at se en billedbog lavet af hendes egne tegninger… ja, i hele 10 minutter! [`markdown-pakken`](http://www.ctan.org/pkg/markdown) lader dig tilpasse, hvordan hver markdown-syntaks gengives til LaTeX, så jeg omdefinerede den standard `![](img_file "caption")` syntaks til at placere billedteksten under billedfilen (uden noget "Figur"-præfiks eller nummerering), og indsatte derefter et sideskift. Det gør det endnu lettere at lave billedbogen. Her er en video, der viser, hvordan man folder hæftet:

{% embed url="<https://www.youtube.com/embed/IAb31rIeGZo>" %}

### Enkle opskriftshæfter

Når man tænker over det, består en opskrift af lister: en liste over ingredienser, en liste over forberedelses- eller tilberedningsinstruktioner og måske en liste over noter (tilberedningstid, antal portioner osv.). Så i stedet for at skrive dette:

```latex
\begin{enumerate}
\item Først gør du dette
\item Så gør du det
...
\end{enumerate}
```

Jeg ville bestemt sætte pris på at kunne skrive dette:

```
#. Først gør du dette
#. Så gør du det
```

Og tilsvarende for ingredienserne:

```
- 2 æg
- en knivspids salt
```

Så for nemt at lave en hurtig opskrift kan vi skrive dette:

```
# Røræg

Tilberedningstid
: 5 minutter

Rækker til
: 1

## Ingredienser
- 4 æg
- 1 tsk smør
- 1/4 kop mælk
- salt, peber (efter smag)

## Instruktioner

#. Pisk æg, mælk...
#. Varm smørret op på panden...
#. ...
```

Hmm, det ser lovende ud. Nogle af os hos Overleaf (og vores familier) bidrog med vores yndlingsopskrifter til hurtige retter (ideelle for førstegangskokke), og jeg satte hurtigt sammen (undskyld ordspillet) en [hurtig opskriftsskabelon](https://www.overleaf.com/read/gscqdhnwzsfg) som du kan skrive med markdown *og* og lave til et mini-hæfte.

[![A recipe booklet produced on Overleaf using markdown](/files/d136612dfc2d25af88d7ef439cd69d3e4a8c32c1)](https://www.overleaf.com/read/gscqdhnwzsfg)

Nu kommer der endnu et sjovt element. Under overfladen er det stadig LaTeX, så vi kan fortsætte med at style de forskellige elementer — sektionsoverskrifter, punktopstillinger, skrifttyper og så videre — ved hjælp af den sædvanlige værktøjskasse af LaTeX-tricks. Det var her, jeg gik lidt over gevind og kom op med *tre* "temaer" til `simple-recipe` -klassen!

### Bonus 1: Nogle forbehold ved brug af markdown-pakken

* SyncTeX vil ikke helt fungere. På Overleaf betyder det, at handlingerne "position i preview" og "klik-i-preview-for-at-hoppe-til-kilde" ikke vil fungere i `markdown` områderne.
* `\\` mister sin normale betydning: det sædvanlige "to mellemrum efterfulgt af en ny linje" `markdown` trick virker ikke her, fordi efterstillede mellemrum bliver fjernet af Lua-parseren, som dokumenteret i [`markdown` pakkedokumentation](http://texdoc.net/pkg/markdown). `\newline` vil dog virke.
* Vær forsigtig med flere understregningstegn på samme linje — det kan være et problem, hvis:

  * du arbejder med mange indeks i dine ligninger (tip: bryd ud af `markdown` -miljøet i sådanne tilfælde);
  * du gerne vil bruge understregningstegn i dine BibTeX-nøgler.

  Du kan sætte `underscores=false` med de nyeste `markdown-pakken` filer for at få understregningstegn i indeks til at virke, men det vil stadig ikke virke med understregningstegn i BibTeX-nøgler.

  **Opdatering** (13. maj 2017): Understregningstegn i BibTeX-nøgler vil virke med `markdown` v2.5.2 og frem — tak, Vít!
* Du vil have nogle vanskeligheder med at vise et bogstaveligt hash-tegn, fordi selv ikke `\#` vil virke! Jeg definerer normalt en ny kommando og bruger den i stedet.

### Bonus 2: Nye funktioner i den opdaterede markdown-pakke

`markdown` v2.4 og nyere tilføjede understøttelse for noget virkelig flot syntaks:

* **Indlejret fodnotesyntaks**: `...^[dette er fodnoten]` (kræver `inlineFootnotes` -indstillingen)
* **Citeringer:**`[@smith1990]` (kræver `citeringer` -indstillingen; vær også opmærksom på understregningstegn i dine BibTeX-nøgler!)
* **Indhegnet kode**: Du kan enten bruge tilder `~` eller backticks `` ` `` som afgrænsning.

```
~~~~
int main() {
  cout << "Hello world!";
  return 0;
}

~~~~
```

Hvis du gerne vil bruge disse nye funktioner, så sørg for at uploade opdaterede versioner af `markdown.lua`, `markdown.tex` og `markdown.sty` til dit projekt — eller du kan bare oprette et nyt projekt ud fra [denne skabelon](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/da/dybtgaende-artikler/32-markdown-into-latex-with-style.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.
