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

# Skriva Markdown i LaTeX-dokument

## Introduktion

För att använda markdown i ett LaTeX-dokument behöver du ladda [`markdown` paketet](https://www.ctan.org/pkg/markdown) i din dokumentpreambel:

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

där `[settings]` är en *valfri* uppsättning parametrar som används för att konfigurera eller aktivera specifika paketsfunktioner. Se `markdown` paketet [dokumentationen](https://anorien.csc.warwick.ac.uk/mirrors/CTAN/macros/generic/markdown/markdown.html) för en [beskrivning av paketparametrarna (alternativen)](https://anorien.csc.warwick.ac.uk/mirrors/CTAN/macros/generic/markdown/markdown.html#options).

Den här artikeln kommer kort att gå igenom både *radbunden* markdown—skriven i ditt dokument—och import av *external* markdown som finns i en textfil.

* **Observera**: Generellt bör användning av markdown i ett LaTeX-dokument betraktas som ett kompletterande och bekvämt alternativ för att skriva vissa delar av dokumentets innehåll, inte som en alternativ syntax som helt ersätter LaTeX självt.

## Använda externa markdown-filer

Använd kommandot

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

för att inkludera markdown-filen `filename`.

Följande exempel infogar en fil som heter `example.md`. Använd länken under kodlistningarna för att öppna dem som ett Overleaf-projekt:

**`main.tex`**

```latex
\documentclass{article}
\title{Använda markdown-paketet}
\usepackage[smartEllipses]{markdown}
\begin{document}

\markdownInput{example.md}

\end{document}
```

**`example.md`**

```latex
%% example.md

# Jag är en markdown-fil.

Och jag kan göra *betoning*.
## Med underrubriker

> Blockcitat är
> skrivna så här.
>
> De kan sträcka sig över flera stycken,
> om du vill.

Använd 3 tankstreck för ett em-dash. Använd 2 tankstreck för
intervall (t.ex. "det är allt i kapitel 12--14").
Tre punkter ... kommer att omvandlas till en ellips
(förutsatt att du inkluderar alternativet smartEllipses
i din preamble). Unicode stöds.
```

[Öppna dessa filer som ett Overleaf-projekt.](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)

Det här exemplet ger följande utdata:

![Grafik som visar utdata från markdown-paketet](/files/f91e36839956443530cb54be007ece38694e86ff)

## Använda inline-markdown

Använd `markdown` miljön:

```latex
\begin{markdown}
...din markdown
ska placeras här...
\end{markdown}
```

för att skriva inline-markdown, som visas i nästa exempel:

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

Använda inline-markdown:

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

Stycken separeras med en tom rad.

2:a stycket. *Kursiv*, **fet**, och `monospace`. Punktlistor
ser ut så här:

* den här
* den där
* den andra

> Blockcitat är
> skrivna så här.
>
> De kan sträcka sig över flera stycken,
> om du vill.

En h2-rubrik
------------

Här är en numrerad lista (använd alternativet `hashEnumerators` om du vill använda hashtecken):

#. första punkten
#. andra punkten
#. tredje punkten

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

[Öppna detta exempel 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)

Det här exemplet ger följande utdata:

![Exempel på sättning av inline-markdown i Overleaf](/files/9d2abd2ef8050aa06f1d87c6938e5e8aedc7deb4)

## Funktioner och alternativ i markdown-paketet

Här kommer vi att utforska några av de [funktioner och alternativ](https://anorien.csc.warwick.ac.uk/mirrors/CTAN/macros/generic/markdown/markdown.html) som tillhandahålls av `markdown` paketet.

### Inkludera kod i markdown

Det finns två sätt att visa kodsnuttar (kodblock) i markdown:

* genom att indentera varje rad i blocket med minst fyra mellanslag eller ett tabbtecken, eller
* genom att använda så kallade [inramade kodblock](#using-fenced-code-blocks)

#### Använda indrag för att visa kodblock

Följande exempel använder 4 eller fler mellanslag i början av varje kodrad—vissa rader använder 6, 8 eller 10 mellanslag beroende på hur stort indrag som krävs:

```latex
\documentclass{article}
\usepackage{markdown}
\begin{document}
Här är några kodfragment indragna med minst 4 mellanslag.
\vspace{6mm}

\begin{markdown}

Här är ett fragment av C:

    /* Låt mig iterera ... */

    int i;
    for(i=0; i<10; i++)
    {
      gör-något(i)
    }

Här är lite HTML:

    <html>
      <head>
        <title>Sidrubrik</title>
      </head>
      <body>
        <h1>Det här är en rubrik</h1>
          <p>Det här är ett stycke.</p>
      </body>
    </html>

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

[Öppna detta exempel 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)

Det här exemplet ger följande utdata:

![Exempel på sättning av kod via markdown](/files/166023c7ebb7ca0bb5582039043602dc7c7f2d10)

#### Använda inramade kodblock

Ett inramat kodblock skapas genom att skriva antingen

* tre bakåtstreck (` ``` `), eller
* tre tilder (`~~~`)

på raderna före och efter kodblocket. Med den här metoden behöver du inte indentera några rader, men du måste använda `fencedCode` alternativet i din preamble:

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

Här är ett exempel som skapar inramade kodblock med 3 bakåtstreck (` ``` `):

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

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

```
    <html>
      <head>
        <title>Sidrubrik</title>
      </head>
      <body>
        <h1>Det här är en rubrik</h1>
          <p>Det här är ett stycke.</p>
      </body>
    </html>
```
\end{markdown}
\end{document}
````

[Öppna detta exempel 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)

Det här exemplet ger följande utdata:

![Använda inramade kodblock med LaTeX-markdownpaketet](/files/83611352e523c56ae0198019c8697b15e1832970)

#### Syntaxmarkering

Inramade kodblock stöder syntaxmarkering genom att språkets namn skrivs efter den första uppsättningen bakåtstreck (`` ` ``). Som exempel identifieras följande block som Javascript genom att skriva den första uppsättningen bakåtstreck som ` ``` js `:

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

För LaTeX kan `minted` paketet användas för syntaxmarkering, som visas i nästa exempel som innehåller lite Javascript (` ``` js `) och 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>Sidrubrik</title>
      </head>
      <body>
        <h1>Det här är en rubrik</h1>
          <p>Det här är ett stycke.</p>
      </body>
    </html>
```
\end{markdown}
\end{document}
````

[Öppna detta exempel 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)

Det här exemplet ger följande utdata:

![Syntaxmarkering med minted och markdown](/files/01e7d602b47976b516d1e01fb95ebc82d73a7906)

### Listor

Tidigare exempel [visar hur man skapar oordnade listor](#using-inline-markdown) i markdown med `*` -tecknet. Ordnade listor kan skapas med `#` -tecknet om `hashEnumerators` alternativet har angetts:

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

Det är också möjligt att skapa nästlade listor, som visas i nästa exempel:

```latex
\documentclass{article}
\usepackage[hashEnumerators]{markdown}
\begin{document}
\begin{markdown}
Här är en numrerad lista som innehåller en nästlad lista:

#. Först, hämta dessa ingredienser:

      * morötter
      * selleri
      * linser

#. Koka upp lite vatten.

#. Häll allt i grytan och följ denna algoritm:

        hitta träslev
        ta av locket på grytan
        rör om
        lägg på locket på grytan
        balansera träsleven osäkert på grytans handtag
        vänta 10 minuter
        gå till första steget (eller stäng av brännaren när du är klar)

    Knuffa inte till träsleven, för då faller den ner.
\end{markdown}
\end{document}
```

[Öppna detta exempel 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)

Det här exemplet ger följande utdata:

![Skapa numrerade listor med LaTeX markdown-paketet](/files/7040a2afa375f7cf026b87f734b8c8212d4c815f)

### Inkludera LaTeX i markdown

Om du aktiverar `hybrid` alternativet kan du blanda LaTeX-kod i Markdown!

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

\begin{markdown}
Inline-matematiska ekvationer kan skapas så här: $\omega = d\phi / dt$.
Visad matematik kan skrivas som:

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

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

[Öppna detta exempel 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)

Det här exemplet ger följande utdata:

![Använda LaTeX-kod i markdown](/files/fee0848bc77989d2e8e498da942d31b50cea5f92)

### Inkludera bilder

* **Obs**: Nästa exempel använder en grafikfil (`example-image.pdf`) som tillhandahålls av `mwe` paketet. Dessa grafikfiler distribueras av TeX Live och lagras därför på Overleafs servrar, vilket gör dem tillgängliga som platshållare för bilder, till exempel i exemplet nedan.

Bilder kan inkluderas i markdown genom att skriva markup med följande format:

```latex
![alt-text](filnamn "bildtext")
```

Förhoppningsvis beskriver parameternamnen `alt-text`, `filnamn` och `"bildtext"` vad de gör. Här är ett exempel som visar dem:

```latex
\documentclass{article}
\usepackage[hybrid]{markdown}
% mwe-paketet tillhandahåller exempelbilder. Att ladda det är
% inte nödvändigt eftersom de bilderna finns i LaTeX:s sökväg.
% Här laddar vi det för tydlighetens skull i detta exempel.
\usepackage{mwe}
\begin{document}
\begin{markdown}
Det här exemplet visar hur man importerar en grafikfil. Här använder vi en
exempelbild som tillhandahålls av paketet `mwe`.

% Använd \setkeys{Gin} om du behöver ändra en bilds visningsstorlek

\setkeys{Gin}{width=.5\linewidth}
![Det här är alternativtext för att beskriva min bild.](example-image.jpg "En exempelbild som tillhandahålls av paketet \texttt{mwe}.")
\end{markdown}
\end{document}
```

[Öppna det här exemplet 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)

Det här exemplet ger följande utdata:

![Visar hur man importerar bilder i markdown](/files/55d5200f635856628d8d7243d67965c2fbf22774)

#### Om bildens bredd

Som de flesta paket `markdown` laddar [`keyval`](https://ctan.org/pkg/keyval?lang=en) och [`graphicx`](https://ctan.org/pkg/graphicx?lang=en), för att kunna använda de kommandon och funktioner de tillhandahåller. Här ställs bildbredden in med `\setkeys` kommandot, som tillhandahålls av `keyvals`. `Gin` är en "familj" av nycklar som definieras av `graphicx` paketet.

* **Obs**: Eftersom ett LaTeX-kommando, här `\setkeys`, används *inom* den `markdown` miljö, krävs `hybrid` alternativet i markdown-paketet.

## Vidare läsning

Overleaf har publicerat andra artiklar om att använda markdown:

* [Hur man skriver i Markdown på Overleaf](/latex/sv/fordjupade-artiklar/30-how-to-write-in-markdown-on-overleaf.md)
* [Markdown till LaTeX med stil](/latex/sv/fordjupade-artiklar/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/sv/kunskapsbas/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.