> 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/kunnskapsbase/166-writing-markdown-in-latex-documents.md).

# Skrive Markdown i LaTeX-dokumenter

## Innledning

For å bruke markdown i et LaTeX-dokument må du laste inn [`markdown` pakken](https://www.ctan.org/pkg/markdown) i dokumentets preamble:

```latex
\usepackage[settings]{markdown}
```

der `[settings]` er et *valgfritt* sett med parametere som brukes til å konfigurere eller aktivere bestemte pakke-funksjoner. Se `markdown` pakken [dokumentasjonen](https://anorien.csc.warwick.ac.uk/mirrors/CTAN/macros/generic/markdown/markdown.html) for en [beskrivelse av pakkens parametere (valg)](https://anorien.csc.warwick.ac.uk/mirrors/CTAN/macros/generic/markdown/markdown.html#options).

Denne artikkelen vil kort gjennomgå både *innebygd* markdown—skrevet i dokumentet ditt—og importering av *external* markdown som finnes i en tekstfil.

* **Merknad**: Generelt bør bruk av markdown i et LaTeX-dokument behandles som et komplementært og praktisk alternativ for å skrive enkelte elementer i dokumentets innhold, ikke som en alternativ syntaks som fullt ut erstatter LaTeX selv.

## Bruk av eksterne markdown-filer

Bruk kommandoen

```latex
\markdownInput{filename}
```

for å inkludere markdown-filen `filename`.

Følgende eksempel setter inn en fil kalt `example.md`. Bruk lenken under kodeoppføringene for å åpne dem som et Overleaf-prosjekt:

**`main.tex`**

```latex
\documentclass{article}
\title{Using the markdown package}
\usepackage[smartEllipses]{markdown}
\begin{document}

\markdownInput{example.md}

\end{document}
```

**`example.md`**

```latex
%% example.md

# Jeg er en markdown-fil.

Og jeg kan gjøre *utheving*.
## Med underoverskrifter

> Blokksitater er
> skrevet slik.
>
> De kan strekke seg over flere avsnitt,
> hvis du vil.

Bruk 3 bindestreker for en tankestrek. Bruk 2 bindestreker for
intervaller (f.eks. "det er alt i kapitlene 12--14").
Tre prikker ... vil bli konvertert til en ellipse
(forutsatt at du inkluderer alternativet smartEllipses
i preamblet ditt). Unicode støttes.
```

[Åpne disse filene som et Overleaf-prosjekt.](https://www.overleaf.com/docs?engine=pdflatex\&snip_name\[]=main.tex\&snip\[]=%5Cdocumentclass%7Barticle%7D%0A%5Ctitle%7BUsing+the+markdown+package%7D%0A%5Cusepackage%5BsmartEllipses%5D%7Bmarkdown%7D%0A%5Cbegin%7Bdocument%7D%0A%0A%5CmarkdownInput%7Bexample.md%7D%0A%0A%5Cend%7Bdocument%7D\&snip_name\[]=example.md\&snip\[]=%25%25+example.md%0A%0A%23+I%27m+a+markdown+file.%0A%0AAnd+I+can+do+%2Aemphasis%2A.%0A%23%23+With+sub-headers%0A%0A%3E+Block+quotes+are%0A%3E+written+like+so.%0A%3E%0A%3E+They+can+span+multiple+paragraphs%2C%0A%3E+if+you+like.%0A%0AUse+3+dashes+for+an+em-dash.+Use+2+dashes+for+%0Aranges+%28ex.%2C+%22it%27s+all+in+chapters+12--14%22%29.+%0AThree+dots+...+will+be+converted+to+an+ellipsis+%0A%28provided+you+include+the+smartEllipses+option+%0Ain+your+preamble%29.+Unicode+is+supported.\&main_document=main.tex)

Dette eksemplet gir følgende resultat:

![Grafikk som viser utdata fra markdown-pakken](/files/29ab96a9836d04a784b29a62c0f166f26a85571e)

## Bruk av inline markdown

Bruk `markdown` -miljøet:

```latex
\begin{markdown}
...markdownen din
skal stå her...
\end{markdown}
```

for å skrive inline markdown, som vist i neste eksempel:

```latex
\documentclass{article}
\usepackage[hashEnumerators,smartEllipses]{markdown}
\begin{document}

Bruk av inline markdown:

\begin{markdown}
En h1-overskrift
============

Avsnitt skilles med en tom linje.

2. avsnitt. *Kursiv*, **fet**, og `monospace`. Punktlister
ser slik ut:

* denne
* den der
* den andre

> Blokksitater er
> skrevet slik.
>
> De kan strekke seg over flere avsnitt,
> hvis du vil.

En h2-overskrift
------------

Her er en nummerert liste (bruk `hashEnumerators`-valget hvis du vil bruke hash-tegn):

#. første element
#. andre element
#. tredje element

\end{markdown}
\end{document}
```

[Åpne dette eksemplet i Overleaf.](https://www.overleaf.com/docs?engine=pdflatex\&snip_name=Using+markdown\&snip=%5Cdocumentclass%7Barticle%7D%0A%5Cusepackage%5BhashEnumerators%2CsmartEllipses%5D%7Bmarkdown%7D%0A%5Cbegin%7Bdocument%7D%0A%0AUsing+inline+markdown%3A%0A%0A%5Cbegin%7Bmarkdown%7D%0AAn+h1+header%0A%3D%3D%3D%3D%3D%3D%3D%3D%3D%3D%3D%3D%0A%0AParagraphs+are+separated+by+a+blank+line.+%0A%0A2nd+paragraph.+%2AItalic%2A%2C+%2A%2Abold%2A%2A%2C+and+%60monospace%60.+Itemized+lists%0Alook+like%3A%0A%0A%2A+this+one%0A%2A+that+one%0A%2A+the+other+one%0A%0A%3E+Block+quotes+are%0A%3E+written+like+so.%0A%3E%0A%3E+They+can+span+multiple+paragraphs%2C%0A%3E+if+you+like.%0A%0AAn+h2+header%0A------------%0A%0AHere%27s+a+numbered+list+%28use+%60hashEnumerators%60+option+if+you+want+to+use+hashes%29%3A%0A%0A%23.+first+item%0A%23.+second+item%0A%23.+third+item%0A%0A%5Cend%7Bmarkdown%7D%0A%5Cend%7Bdocument%7D)

Dette eksemplet gir følgende resultat:

![Eksempel på inline markdown satt i typografi i Overleaf](/files/43047460f4121e3a3586ad1d61169f6fa05d85c8)

## Funksjoner og valg i Markdown-pakken

Her vil vi utforske noen av [funksjonene og valgene](https://anorien.csc.warwick.ac.uk/mirrors/CTAN/macros/generic/markdown/markdown.html) som tilbys av `markdown` pakken.

### Inkludering av kode i markdown

Det finnes to mekanismer for å vise kodebiter (kodeblokker) i markdown:

* ved å rykke inn hver linje i blokken med minst fire mellomrom eller én tabulator, eller
* ved å bruke såkalte [innrammede kodeblokker](#using-fenced-code-blocks)

#### Bruk av innrykk for å vise kodeblokker

Følgende eksempel bruker 4, eller flere, mellomrom ved starten av hver kodelinje—noen linjer bruker 6, 8 eller 10 mellomrom, avhengig av hvor stort innrykk som kreves:

```latex
\documentclass{article}
\usepackage{markdown}
\begin{document}
Her er noen kodefragmenter innrykket med minst 4 mellomrom.
\vspace{6mm}

\begin{markdown}

Her er et fragment av C:

    /* La meg iterere ... */

    int i;
    for(i=0; i<10; i++)
    {
      do-something(i)
    }

Her er noe HTML:

    <html>
      <head>
        <title>Page Title</title>
      </head>
      <body>
        <h1>Dette er en overskrift</h1>
          <p>Dette er et avsnitt.</p>
      </body>
    </html>

\end{markdown}
\end{document}
```

[Åpne dette eksemplet i Overleaf.](https://www.overleaf.com/docs?engine=pdflatex\&snip_name=Using+markdown+code+snippets\&snip=%5Cdocumentclass%7Barticle%7D%0A%5Cusepackage%7Bmarkdown%7D%0A%5Cbegin%7Bdocument%7D%0AHere+are+some+code+fragments+indented+by+at+least+4+space+characters.%0A%5Cvspace%7B6mm%7D%0A%0A%5Cbegin%7Bmarkdown%7D%0A%0AHere+is+a+fragment+of+C%3A%0A%0A++++%2F%2A+Let+me+iterate+...+%2A%2F%0A%0A++++int+i%3B%0A++++for%28i%3D0%3B+i%3C10%3B+i%2B%2B%29%0A++++%7B%0A++++++do-something%28i%29%0A++++%7D%0A%0AHere+is+some+HTML%3A%0A%0A++++%3Chtml%3E%0A++++++%3Chead%3E%0A++++++++%3Ctitle%3EPage+Title%3C%2Ftitle%3E%0A++++++%3C%2Fhead%3E%0A++++++%3Cbody%3E%0A++++++++%3Ch1%3EThis+is+a+Heading%3C%2Fh1%3E%0A++++++++++%3Cp%3EThis+is+a+paragraph.%3C%2Fp%3E%0A++++++%3C%2Fbody%3E%0A++++%3C%2Fhtml%3E%0A%0A%5Cend%7Bmarkdown%7D%0A%5Cend%7Bdocument%7D)

Dette eksemplet gir følgende resultat:

![Eksempel på typografering av kode via markdown](/files/0231048de46d3528144ea5a00fb518c806f33177)

#### Bruk av innrammede kodeblokker

En innrammet kodeblokk opprettes ved å skrive enten

* tre backticks (` ``` `), eller
* tre tilder (`~~~`)

på linjene før og etter kodeblokken. Med denne metoden trenger du ikke å rykke inn noen linjer, men du må bruke `fencedCode` valget i preamblet ditt:

```latex
\usepackage[fencedCode]{markdown}
```

Her er et eksempel som lager innrammede kodeblokker ved bruk av 3 backticks (` ``` `):

````latex
\documentclass{article}
\usepackage[fencedCode]{markdown}
\begin{document}
\begin{markdown}

```
if (a > 3) {
    moveShip(5 * gravity, DOWN);
}
```

```
    <html>
      <head>
        <title>Page Title</title>
      </head>
      <body>
        <h1>Dette er en overskrift</h1>
          <p>Dette er et avsnitt.</p>
      </body>
    </html>
```
\end{markdown}
\end{document}
````

[Åpne dette eksemplet i Overleaf.](https://www.overleaf.com/docs?engine=pdflatex\&snip_name=Using+markdown+fenced+code+blocks\&snip=%5Cdocumentclass%7Barticle%7D%0A%5Cusepackage%5BfencedCode%5D%7Bmarkdown%7D%0A%5Cbegin%7Bdocument%7D%0A%5Cbegin%7Bmarkdown%7D%0A%0A%60%60%60%0Aif+%28a+%3E+3%29+%7B%0A++++moveShip%285+%2A+gravity%2C+DOWN%29%3B%0A%7D%0A%60%60%60%0A%0A%60%60%60%0A++++%3Chtml%3E%0A++++++%3Chead%3E%0A++++++++%3Ctitle%3EPage+Title%3C%2Ftitle%3E%0A++++++%3C%2Fhead%3E%0A++++++%3Cbody%3E%0A++++++++%3Ch1%3EThis+is+a+Heading%3C%2Fh1%3E%0A++++++++++%3Cp%3EThis+is+a+paragraph.%3C%2Fp%3E%0A++++++%3C%2Fbody%3E%0A++++%3C%2Fhtml%3E%0A%60%60%60%0A%5Cend%7Bmarkdown%7D%0A%5Cend%7Bdocument%7D)

Dette eksemplet gir følgende resultat:

![Bruk av innrammede kodeblokker med markdown LaTeX-pakken](/files/e51f8e90d6f1781d768416c6ea8973f8dcdc2412)

#### Syntaksutheving

Innrammede kodeblokker støtter syntaksutheving ved at navnet på språket skrives etter det første settet med backticks (`` ` ``). Som et eksempel identifiseres den følgende blokken som Javascript ved å skrive det første settet med backticks som ` ``` js `:

````latex
``` js
if (a > 3) {
    moveShip(5 * gravity, DOWN);
}
```
````

For LaTeX kan `minted` pakken brukes til syntaksutheving, som vist i neste eksempel som inneholder noe Javascript (` ``` js `) og HTML (` ``` html `):

````latex
\documentclass{article}
\usepackage{minted}
\usepackage[fencedCode]{markdown}
\begin{document}
\begin{markdown}

``` js
if (a > 3) {
    moveShip(5 * gravity, DOWN);
}
```

``` html
    <html>
      <head>
        <title>Page Title</title>
      </head>
      <body>
        <h1>Dette er en overskrift</h1>
          <p>Dette er et avsnitt.</p>
      </body>
    </html>
```
\end{markdown}
\end{document}
````

[Åpne dette eksemplet i Overleaf.](https://www.overleaf.com/docs?engine=pdflatex\&snip_name=Using+markdown+fenced+code+blocks\&snip=%5Cdocumentclass%7Barticle%7D%0A%5Cusepackage%7Bminted%7D%0A%5Cusepackage%5BfencedCode%5D%7Bmarkdown%7D%0A%5Cbegin%7Bdocument%7D%0A%5Cbegin%7Bmarkdown%7D%0A%0A%60%60%60+js%0Aif+%28a+%3E+3%29+%7B%0A++++moveShip%285+%2A+gravity%2C+DOWN%29%3B%0A%7D%0A%60%60%60%0A%0A%60%60%60+html%0A++++%3Chtml%3E%0A++++++%3Chead%3E%0A++++++++%3Ctitle%3EPage+Title%3C%2Ftitle%3E%0A++++++%3C%2Fhead%3E%0A++++++%3Cbody%3E%0A++++++++%3Ch1%3EThis+is+a+Heading%3C%2Fh1%3E%0A++++++++++%3Cp%3EThis+is+a+paragraph.%3C%2Fp%3E%0A++++++%3C%2Fbody%3E%0A++++%3C%2Fhtml%3E%0A%60%60%60%0A%5Cend%7Bmarkdown%7D%0A%5Cend%7Bdocument%7D)

Dette eksemplet gir følgende resultat:

![Syntaksutheving med minted og markdown](/files/b0094a8b56f57826500ebc0f2aa811962d313b27)

### Lister

Tidligere eksempler [viser hvordan man lager usorterte lister](#using-inline-markdown) i markdown ved hjelp av `*` tegnet. Sorterte lister kan opprettes ved å bruke `#` tegnet hvis `hashEnumerators` valget er spesifisert:

```latex
\usepackage[hashEnumerators]{markdown}
```

Det er også mulig å lage nestede lister, som vist i neste eksempel:

```latex
\documentclass{article}
\usepackage[hashEnumerators]{markdown}
\begin{document}
\begin{markdown}
Her er en nummerert liste som inneholder en nestet liste:

#. Først, skaff disse ingrediensene:

      * gulrøtter
      * selleri
      * linser

#. Kok opp litt vann.

#. Ha alt i kjelen og følg denne algoritmen:

        finn tresleiv
        ta av lokket
        rør
        legg på lokket
        balanser tresleiven usikkert på kjelehandtaket
        vent 10 minutter
        gå til første steg (eller slå av platen når du er ferdig)

    Ikke støt borti tresleiven, ellers faller den.
\end{markdown}
\end{document}
```

[Åpne dette eksemplet i Overleaf.](https://www.overleaf.com/docs?engine=pdflatex\&snip_name=Creating+a+nested+list+in+markdown\&snip=%5Cdocumentclass%7Barticle%7D%0A%5Cusepackage%5BhashEnumerators%5D%7Bmarkdown%7D%0A%5Cbegin%7Bdocument%7D%0A%5Cbegin%7Bmarkdown%7D%0AHere+is+a+numbered+list+that+contains+a+nested+list%3A%0A%0A%23.+First%2C+get+these+ingredients%3A%0A%0A++++++%2A+carrots%0A++++++%2A+celery%0A++++++%2A+lentils%0A%0A%23.+Boil+some+water.%0A%0A%23.+Dump+everything+in+the+pot+and+follow+this+algorithm%3A%0A%0A++++++++find+wooden+spoon%0A++++++++uncover+pot%0A++++++++stir%0A++++++++cover+pot%0A++++++++balance+wooden+spoon+precariously+on+pot+handle%0A++++++++wait+10+minutes%0A++++++++goto+first+step+%28or+shut+off+burner+when+done%29%0A%0A++++Do+not+bump+wooden+spoon+or+it+will+fall.%0A%5Cend%7Bmarkdown%7D%0A%5Cend%7Bdocument%7D)

Dette eksemplet gir følgende resultat:

![Opprette nummererte lister ved bruk av LaTeX-pakken markdown](/files/432f5ed7ed5079f3c3fe5cf1f1804889457d5f78)

### Inkludering av LaTeX i markdown

Hvis du aktiverer `hybrid` valget, kan du blande LaTeX-kode i Markdown!

```latex
\documentclass{article}
\usepackage[hybrid]{markdown}
\begin{document}

\begin{markdown}
Inline matematiske ligninger kan lages slik: $\omega = d\phi / dt$.
Visningsmatematikk kan skrives som:

\begin{equation}
I = \int \rho R^{2} dV
\end{equation}

\end{markdown}
\end{document}
```

[Åpne dette eksemplet i Overleaf.](https://www.overleaf.com/docs?engine=pdflatex\&snip_name=Using+LaTeX+code+in+markdown\&snip=%5Cdocumentclass%7Barticle%7D%0A%5Cusepackage%5Bhybrid%5D%7Bmarkdown%7D%0A%5Cbegin%7Bdocument%7D%0A%0A%5Cbegin%7Bmarkdown%7D%0AInline+math+equations+can+be+created+like+this%3A+%24%5Comega+%3D+d%5Cphi+%2F+dt%24.+%0ADisplay+math+can+be+written+as%3A%0A%0A%5Cbegin%7Bequation%7D%0AI+%3D+%5Cint+%5Crho+R%5E%7B2%7D+dV%0A%5Cend%7Bequation%7D%0A%0A%5Cend%7Bmarkdown%7D%0A%5Cend%7Bdocument%7D)

Dette eksemplet gir følgende resultat:

![Bruk av LaTeX-kode i markdown](/files/e30a85be791cdb2ed2709295560a2ff469963910)

### Inkludering av bilder

* **Merk**: Det neste eksemplet bruker en bildefil (`example-image.pdf`) som tilbys av `mwe` pakken. Disse bildefilene distribueres av TeX Live og er derfor lagret på Overleafs servere, noe som gjør dem tilgjengelige som plassholderbilder, slik som i eksemplet nedenfor.

Bilder kan inkluderes i markdown ved å skrive markering i følgende format:

```latex
![alt-text](file-name "image caption")
```

Forhåpentligvis beskriver parameternavnene `alt-tekst`, `filnavn` og `"billedtekst"` hva de gjør. Her er et eksempel som viser dem:

```latex
\documentclass{article}
\usepackage[hybrid]{markdown}
% mwe-pakken gir eksempelbilder. Å laste den inn er
% ikke nødvendig fordi disse bildene ligger i LaTeX sin søkesti.
% Her laster vi den inn for klarhetens skyld i dette eksemplet.
\usepackage{mwe}
\begin{document}
\begin{markdown}
Dette eksemplet viser hvordan man importerer en bildefil. Her bruker vi et
eksempelbilde levert av `mwe`-pakken.

% Bruk \setkeys{Gin} hvis du trenger å endre et billedes visningsstørrelse

\setkeys{Gin}{width=.5\linewidth}
![Dette er alt-tekst som beskriver bildet mitt.](example-image.jpg "Et eksempelbilde levert av \texttt{mwe}-pakken.")
\end{markdown}
\end{document}
```

[Åpne dette eksemplet på 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 eksemplet gir følgende resultat:

![Viser hvordan man importerer bilder i markdown](/files/34155a000554899162bc0415d80703b83bce6db6)

#### Merknad om bildebredde

Som de fleste pakker, `markdown` laster den inn andre pakker, inkludert [`keyval`](https://ctan.org/pkg/keyval?lang=en) og [`graphicx`](https://ctan.org/pkg/graphicx?lang=en)for å kunne bruke kommandoene og funksjonene de tilbyr. Her settes bildebredden ved hjelp av `\setkeys` kommandoen, som tilbys av `keyvals`. `Gin` er en «familie» av nøkler definert av `graphicx` pakken.

* **Merk**: Siden en LaTeX-kommando, her `\setkeys`, brukes *inne i* den `markdown` miljøet, er `hybrid` valget i markdown-pakken påkrevd.

## Videre lesning

Overleaf har publisert andre artikler om bruk av markdown:

* [Hvordan skrive i Markdown på Overleaf](/latex/no/dybdeartikler/30-how-to-write-in-markdown-on-overleaf.md)
* [Markdown til LaTeX med stil](/latex/no/dybdeartikler/32-markdown-into-latex-with-style.md)


---

# 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/kunnskapsbase/166-writing-markdown-in-latex-documents.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.