> 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/fordjupade-artiklar/32-markdown-into-latex-with-style.md).

# Markdown till LaTeX med stil

**Uppdatering efter publicering** (13 maj 2017): Vi är tacksamma mot Vít Novotný, författaren/underhållaren av `markdown` paketet, för att han skrev till oss med några hjälpsamma synpunkter angående den ursprungliga artikeln. Vi är glada att publicera denna uppdaterade version som tar hänsyn till, och inkluderar, hans råd och förslag.

### Introduktion

För en tid sedan gladdes vi åt lanseringen av [`markdown-paketet`](http://www.ctan.org/pkg/markdown) som gjorde det möjligt att skriva markdown-syntax i LaTeX-dokument – och firade det med en artikel som kallades [Hur man skriver i Markdown i Overleaf](/latex/sv/fordjupade-artiklar/30-how-to-write-in-markdown-on-overleaf.md) vars syfte var att demonstrera en del av den syntax som stöds.

**Kom ihåg**: Du behöver kompilera dina `.tex` filer med `--shell-escape` alternativet för att få det att fungera på lokala LaTeX-installationer – Overleaf gör detta åt dig (automatiskt). Tänk på att de flesta portaler för inlämning av tidskriftsartiklar inte aktiverar `--shell-escape`—om du inte bara får ladda upp PDF-filen med ditt manuskript kan dina LaTeX-filer som innehåller markdown kanske inte kompileras framgångsrikt när de behandlas av förlagets insändningssystem.

En av idéerna som antyddes i den [tidigare artikeln](/latex/sv/fordjupade-artiklar/30-how-to-write-in-markdown-on-overleaf.md) är att en kombination av markdown och LaTeX möjliggör en underbar separation mellan innehåll och stil. Författare (särskilt de som redan är bekanta med markdown) skulle ha en mycket mer koncis syntax att arbeta med (med vissa förbehåll) samtidigt som de fortfarande har tillgång till alla fördelar med LaTeX-paket och mallar för att ta hand om stil och formatering. Den [tidigare artikeln](/latex/sv/fordjupade-artiklar/30-how-to-write-in-markdown-on-overleaf.md) gav några exempel på hur man använder markdown i [Beamer-presentationer](https://www.overleaf.com/read/dnrwnjrpjjhw) och [affischer](https://www.overleaf.com/read/jtbgmmgqrqmh): idag ska vi titta på ännu fler roliga och spännande formateringsmöjligheter!

### Använda markdown i formaterade LaTeX-mallar

Förutom exemplen ovan kan du använda markdown i nästan alla mallar. Här är några snabba exempel:

* Den [Legrange orange bok](https://www.overleaf.com/latex/templates/the-legrand-orange-book-template-english/jtctyfmnpppc) mall
* Den [Tufteinspirerat kompendium](https://www.overleaf.com/latex/templates/handout-design-inspired-by-edward-tufte/dtsbhhkvghzz) mall
* Denna [mycket fin artikelmall](https://www.overleaf.com/read/xfsrpsmdtqvt) av Thiago

Du kanske märker att två av dessa är artikelmallar och en är en bokmall. Den [`markdown-paketet`](http://www.ctan.org/pkg/markdown) upptäcker om `\chapter` kommandot är tillgängligt för användning i ett visst LaTeX-dokument och kommer att få första nivåns rubrikrad att återges `markdown` som `\chapter` eller `\section` på lämpligt sätt.

### Riktigt snabba utdelningar: markdown + pocketmod

Sedan jag först lärde mig om markdown framstod det som ett snabbt och smidigt sätt att ta anteckningar: det speglar hur jag kanske klottrar ner anteckningar på papperslappar eller post-it-lappar – särskilt med syntaxen för punktlistor och numrerade listor. När jag först skapade [PocketMod-mallen](https://www.overleaf.com/read/nqbhpnrkskrx) 2015 längtade jag efter ett sätt att skriva markdown i LaTeX så att jag kunde skapa PocketMods *med* markdown eftersom det kändes … passande. Att skriva ner anteckningar i en enkel syntax på små vikta häften, men med snygg typografi – vissa kallar PocketMods för "zines" eftersom de är små häften på 8 sidor som du kan göra av ett enda A4-ark.

Och faktiskt, det var möjligt! Detta gör det ganska enkelt att snabbt producera en [liten veckoplanerare](https://www.overleaf.com/read/zfzcxygqwqsq) eller en liten [bilderbok](https://www.overleaf.com/read/rppnsfgnrhsf). Ja, det roade min dotter att se en bilderbok gjord av hennes egna teckningar … i hela 10 minuter!  [`markdown-paketet`](http://www.ctan.org/pkg/markdown) låter dig anpassa hur varje markdown-syntax återges i LaTeX, så jag omdefinierade den vanliga `![](img_file "bildtext")` syntaxen för att placera bildtexten under bildfilen (utan något prefix med "Figure" eller numrering), och infogade sedan en sidbrytning. Detta gör det ännu enklare att göra bilderboken. Här är en video som visar hur man viker häftet:

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

### Enkla recepthäften

Om man tänker efter består ett recept av listor: en lista över ingredienser, en lista över tillagnings- eller matlagningsinstruktioner, och kanske en lista med anteckningar (tillagningstid, portioner osv). Så istället för att skriva detta:

```latex
\begin{enumerate}
\item Gör först detta
\item Gör sedan det där
...
\end{enumerate}
```

Jag skulle verkligen uppskatta att kunna skriva detta:

```
#. Gör först detta
#. Gör sedan det där
```

Och på samma sätt för ingredienserna:

```
- 2 ägg
- en nypa salt
```

Så för att enkelt skapa ett snabbt recept kan vi skriva detta:

```
# Äggröra

Tillagningstid
: 5 minuter

Portioner
: 1

## Ingredienser
- 4 ägg
- 1 tsk smör
- 1/4 kopp mjölk
- salt, peppar (efter smak)

## Instruktioner

#. Vispa ägg, mjölk...
#. Hetta upp smör i en panna...
#. ...
```

Hmm, det ser lovande ut. Några av oss på Overleaf (och våra familjer) bidrog med våra favorit-snabba recept (perfekta för förstagångskockar) och jag svängde ihop (ursäkta ordvitsen) en [mall för snabba recept](https://www.overleaf.com/read/gscqdhnwzsfg) som du kan skriva med markdown *och* göra om till ett litet häfte.

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

Nu kommer ytterligare lite roligt. Under ytan är detta fortfarande LaTeX så vi kan fortsätta att formge de olika elementen – avsnittsrubriker, punktlistor, typsnitt och så vidare – med de vanliga LaTeX-tricken. Det var då jag blev ganska ivrig och kom på *tre* "teman" för `simple-recipe` klassen!

### Bonus 1: Några förbehåll när du använder markdown-paketet

* SyncTeX fungerar inte riktigt. På Overleaf betyder detta att operationerna "position i förhandsvisning" och "klicka i förhandsvisning för att hoppa till källan" inte fungerar i `markdown` områdena.
* `\\` tappar sin normala betydelse: det vanliga "två mellanslag följt av en ny rad" `markdown` tricket fungerar inte här eftersom avslutande mellanslag tas bort av Lua-parsern, som dokumenteras i [`markdown` paketdokumentation](http://texdoc.net/pkg/markdown). `\newline` fungerar dock.
* Var försiktig med flera understreck på samma rad – detta kan vara ett problem om:

  * du arbetar med många index i dina ekvationer (tips: lämna miljön i sådana fall); `markdown` du gillar att använda understreck i dina BibTeX-nycklar.
  * Du kan ange

  underscores=false `med de senaste` filerna för att få understreck som används för index att fungera, men det fungerar fortfarande inte med understreck i BibTeX-nycklar. `markdown-paketet` Uppdatering

  **(13 maj 2017): Understreck i BibTeX-nycklar fungerar med** v2.5.2 och framåt – tack Vít! `markdown` Du kommer att ha vissa svårigheter att visa ett bokstavligt hash-tecken eftersom inte ens
* kommer att fungera! Jag brukar definiera ett nytt kommando och använda det i stället. `\#` Bonus 2: Nya funktioner i det uppdaterade markdown-paketet

### v2.4 och senare lade till stöd för en del riktigt trevlig syntax:

`markdown` Inbäddad fotnotsyntax

* **...^\[det här är fotnoten]**: `(kräver` inlineFootnotes `alternativet)` Citeringar:
* **\[@smith1990]**`citeringar` inlineFootnotes `alternativet; var också försiktig med understreck i dina BibTeX-nycklar!)` alternativet; var också försiktig med understreck i dina BibTeX-nycklar!)
* **Inramad kod**: Du kan använda antingen tilder `~` eller backticks `` ` `` som avgränsare.

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

~~~~
```

Om du vill använda dessa nya funktioner, se till att ladda upp uppdaterade versioner av `markdown.lua`, `markdown.tex` och `markdown.sty` till ditt projekt – eller så kan du bara skapa ett nytt projekt från [denna mall](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/sv/fordjupade-artiklar/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.
