> 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/30-how-to-write-in-markdown-on-overleaf.md).
# Sådan skriver du i Markdown i Overleaf
**Opdatering efter udgivelsen** (tilføjet 13. maj 2017): Vi er taknemmelige over for Vít Novotný, forfatteren/vedligeholderen af `markdown` pakken, for at skrive til os med nogle nyttige tilbagemeldinger vedrørende den oprindelige artikel. Vi er glade for at offentliggøre denne opdaterede version, som tager højde for og inkluderer hans råd og forslag.
### Huh, hvad?
[Markdown](https://kirkstrobeck.github.io/whatismarkdown.com/) er et letvægts-markup-sprog (forstår du? 😉), som lader dig skrive noget i ren tekst med nogle *meget* enkle regler og derefter omdanne det til formaterede output, f.eks. HTML. Det er meget populært blandt softwareudviklere og programmører, netop på grund af dets enkelhed (og må jeg tilføje, også perfekt til at tage noter!).
For eksempel, for at skrive en hurtig indkøbsliste:
```
# Indkøbsliste
*Husk* at få fat i så meget som muligt under de kommende [udsalg](http://acme-marg.com)!
## Mad
- bagte bønner
- spaghetti
## Kontorartikler
- skriveblok
- blyanter
```
Og du får som HTML-output ved hjælp af et værktøj såsom [pandoc](http://pandoc.org/):
```html
Indkøbsliste
Husk at få fat i så meget som muligt under de kommende udsalg!
Mad
Kontorartikler
```
Dejligt og enkelt! Du kan finde anden syntaks til Markdown [her](https://daringfireball.net/projects/markdown/syntax).
### Hvad betyder det så for mig?
Mange LaTeX-brugere er tilfredse med deres smukt opsatte LaTeX-dokumenter, men kan ikke lade være med at føle et stik af misundelse over for Markdown-brugere—fordi, ja, LaTeX-markup *kan* kan til tider blive temmelig ordrigt. Ja, lister, vi ser på *jer*...
De gode nyheder er, at den fantastiske nye [`markdown` LaTeX-pakke](https://ctan.org/pkg/markdown) lader dig skrive markdown-syntaks i dine LaTeX-dokumenter (dvs. enklere input) og stadig få smukt opsatte PDF-filer! Alt, hvad du skal gøre, er at indlæse `markdown` pakken i dit dokument og omslutte dit Markdown-materiale i en `markdown` miljø:
```latex
\documentclass{article}
\usepackage{markdown}
\begin{document}
\begin{markdown}
# Indkøbsliste
*Husk* at få fat i så meget som muligt under de kommende [udsalg](http://acme-marg.com)!
## Mad
- bagte bønner
- spaghetti
## Kontorartikler
- skriveblok
- blyanter
\end{markdown}
\end{document}
```
Eller hvis du foretrækker at lægge dit Markdown-materiale i en `*.md` fil:
```latex
\documentclass{article}
\usepackage{markdown}
\begin{document}
\markdownInput{example.md}
\end{document}
```
Fedt! Det vil sandsynligvis gøre udviklertyper meget glade, fordi de nu bare kan kopiere deres `.md` dokumentation over!
### Kan jeg stadig bruge LaTeX-kommandoer, hvis jeg skriver Markdown?
Ja, du kan stadig bruge LaTeX-kommandoer i dit Markdown-materiale! Du skal bare give `hybrid` indstillingen til `markdown`:
```latex
\usepackage[hybrid]{markdown}
...
- skriveblok (den slags med det store $E=mc^2$ på omslaget)
```
### Hvordan kan jeg bruge bogstavelige tegn som '#' og '\_' (understregninger)?
#### At skrive et '#'
Du kan ikke skrive tegnet '#' *inde i `markdown` miljøet*. Ikke engang `\#` vil virke. Du skal definere en kommando som `\newcommand{\texthash}{\#}`, og derefter bruge `\texthash` i dine `markdown` miljøet. Tilsvarende for understregninger, især når der er mere end én på samme linje, f.eks. `$y = m_1 + n_2$`. Nogle gange kan det være lettere at afslutte det aktuelle `markdown` miljø og skrive problematiske linjer i almindelig LaTeX-tilstand og derefter starte et andet `markdown` miljøet.
#### At skrive '\_' (understregning) og '\`' (backtick)
**Opdatering** (tilføjet 13. maj 2017): Siden `markdown` version 2.5 kan du sætte `underscores = false` og `codeSpans = false` for at deaktivere understregninger og backticks. Det gør det muligt at skrive matematiske subskrifter og anførselstegn i hybridtilstand uden escaping. Vi har asterisker til fremhævning, så det eneste, der virkelig går tabt, er eksempler på indlejret kode. Tak til Vít for tippet!
#### Miljøer, der skal undgås...
Og selvom du kan bruge backticks til at skrive inline-verbatim eller indrykke linjen med fire mellemrum for en verbatim-blok, så brug ikke `lstlisting` og heller ikke `minted` LaTeX-miljøer inden i `markdown` miljøer. Bare lad være.
#### Brug af HTML i et markdown-miljø
Og nej, du kan ikke bruge HTML inde i LaTeX- `markdown` miljøet (selvom det er noget, man ofte gør i almindelig Markdown). Beklager.
**Opdatering** (tilføjet 13. maj 2017): Fra `markdown` v2.3 er der en `html` indstilling, som ikke viser HTML-tags ordret, hvis de findes i dit markdown-materiale, men den formaterer heller ikke selve tag-indholdet—dvs. `Hej!` vil bare vise Hej! med normal skrift. Men HTML-enheder som `©` vil blive gengivet som ©. Tak til Vít for at gøre opmærksom på dette.
### Foreslåede pakkemuligheder til markdown
Et sæt `markdown` pakkemuligheder, som du måske vil finde nyttige, er:
```latex
\usepackage[footnotes,definitionLists,hashEnumerators,smartEllipses,hybrid]{markdown}
```
Disse indstillinger aktiverer brugen af
* markdown-syntaks til fodnoter (som `[^1]`);
* definitionslister og `#` til nummererede lister;
* "rigtige" ellipseprikker (…).
Her er en [fuldstændig eksempel](https://www.overleaf.com/latex/examples/using-markdown-in-latex-documents/whdrnpcpnwrm) i Overleaf-galleriet, og her er [et andet](https://www.overleaf.com/articles/how-to-write-using-rich-text-format-and-markdown-in-latex-and-overleaf/dbqrxvftzskw).
### Hyperlinks og fodnoter: hvordan?
I Overleaf-eksemplet er hyperlinket en fodnote. Hvordan får jeg det til at være et hyperref-hyperlink?
`markdown` kan tilpasses, så du kan definere, hvordan du ønsker, at forskellige elementer skal gengives. Hvis du tilføjer disse til din preamble, gør du netop det:
```latex
\markdownSetup{renderers={
link = {\href{#2}{#1}}
}}
```
**Opdatering** (tilføjet 13. maj 2017): `rendererPrototypes` blev brugt i den oprindelige version. Almindelige brugere anbefales at bruge `renderers` til deres egne definitioner, da `rendererPrototypes` er der for, at pakkeudviklere kan angive standardværdier. Hvis du ændrer `rendererPrototypes`, risikerer du, at en anden pakke kan overskrive dine indstillinger. Tak til Vít for at gøre opmærksom på dette!
### Indsættelse af billeder (opdateret 8. november 2022)
* **Bemærk**: Det næste eksempel bruger en grafikfil (`example-image.pdf`) leveret af `mwe` pakken. Disse grafikfiler distribueres af TeX Live og er derfor gemt på Overleafs servere, hvilket gør dem tilgængelige som billedepladsholdere, såsom i eksemplet nedenfor.
Billeder kan inkluderes i markdown ved at skrive markup i følgende format:
```latex
```
Forhåbentlig beskriver parameternavnene `alt-tekst`, `filnavn` og `"billedtekst"` hvad de gør. Her er et eksempel, der demonstrerer dem:
```latex
\documentclass{article}
\usepackage[hybrid]{markdown}
% mwe-pakken indeholder eksempelbilleder. Det er
% ikke nødvendigt, fordi disse billeder er i LaTeX's søgesti.
% Her indlæser vi den for tydelighedens skyld i dette eksempel.
\usepackage{mwe}
\begin{document}
\begin{markdown}
Dette eksempel viser, hvordan man importerer en grafikfil. Her bruger vi et
eksempelbillede leveret af pakken `mwe`.
% Brug \setkeys{Gin}, hvis du har brug for at ændre et billedes visningsstørrelse
\setkeys{Gin}{width=.5\linewidth}
\end{markdown}
\end{document}
```
[Åbn dette eksempel i Overleaf.](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)
Dette eksempel giver følgende output:
#### Bemærkning om billedbredden
Som de fleste pakker, `markdown` indlæser andre pakker, herunder [`keyval`](https://ctan.org/pkg/keyval?lang=en) og [`graphicx`](https://ctan.org/pkg/graphicx?lang=en), for at kunne bruge de kommandoer og funktioner, de tilbyder. Her angives billedbredden ved hjælp af `\setkeys` kommandoen, som leveres af `keyvals`. `Gin` er en "familie" af nøgler defineret af `graphicx` pakken.
* **Bemærk**: Fordi en LaTeX-kommando, her `\setkeys`, bruges *i* den `markdown` miljøet, er `hybrid` indstillingen i markdown-pakken påkrævet.
#### Ændring af identifikatorer for flydende placering (mere avanceret)
Markdown-syntaksen til indsættelse af figurer lader dig ikke direkte angive identifikatorerne for flydende placering, men du kan justere dem ved at redefinere, hvordan figuren gengives:
```latex
\markdownSetup{renderers={
image = {\begin{figure}[hbt!]
\\centering
\includegraphics{#3}%
\ifx\empty#4\empty\else
\caption{#4}%
\fi
\end{figure}}
}}
```
For mere information henvises til [markdown-dokumentationen](https://mirror.apps.cam.ac.uk/pub/tex-archive/macros/generic/markdown/markdown.html).
### Kan du lave tabeller ved hjælp af markdown i LaTeX? 😀
Desværre nej. Tabeller understøttes kun i [MultiMarkdown](http://fletcherpenney.net/multimarkdown/) og LaTeX- `markdown` pakken understøtter det ikke på nuværende tidspunkt.
**Opdatering** (tilføjet 13. maj 2017): Baseret på et tip fra Vít er det muligt at bruge `contentBlocks` syntaksudvidelsen siden version 2.4 eller justere `inputFencedCode` rendereren for hurtigt at omdanne noget CSV-lignende tekst til en tabel.
### Flere lækkerier i markdown-pakken...?
Som nævnt tidligere er det en smart måde at tage noter på, og når det kombineres med nogle gode LaTeX-dokumentklasser eller pakkeopsætninger, kan du få en smuk notesbog allerede ved forelæsningsslut. For eksempel kunne du bruge det sammen med [Tufte-klasserne](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}
```
Og den korte og enkle syntaks, som gør det langt mere bekvemt at skrive lister, betyder, at vi nu har en *virkelig hurtig* måde at skrive [Beamer-præsentationer](https://www.overleaf.com/latex/examples/writing-beamer-slides-with-markdown/dnrwnjrpjjhw) og [plakater](https://www.overleaf.com/latex/examples/writing-beamer-slides-with-markdown/dnrwnjrpjjhw)!
God fornøjelse!
---
# 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/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.