> 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/30-how-to-write-in-markdown-on-overleaf.md).
# Hur man skriver i Markdown i Overleaf
**Uppdatering efter publicering** (tillägg 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 om den ursprungliga artikeln. Vi är glada att publicera denna uppdaterade version som tar hänsyn till, och innehåller, hans råd och förslag.
### Va, vadå?
[Markdown](https://kirkstrobeck.github.io/whatismarkdown.com/) är ett lättviktigt märkspråk (fattar du? 😉) som låter dig skriva något i vanlig text med några *mycket* enkla regler, och sedan omvandla det till formaterade utdata, t.ex. HTML. Det är mycket populärt bland mjukvaruutvecklare och programmerare, just på grund av sin enkelhet (och får jag tillägga, perfekt för anteckningar också!).
Till exempel, för att skriva en snabb inköpslista:
```
# Inköpslista
*Kom ihåg* att ta så mycket vi kan under kommande [reor](http://acme-marg.com)!
## Mat
- bönor i tomatsås
- spaghetti
## Skrivmateriel
- skrivblock
- pennor
```
Och du får som HTML-utdata, med ett verktyg som [pandoc](http://pandoc.org/):
```html
Inköpslista
Kom ihåg att ta så mycket vi kan under kommande reor!
Mat
- bönor i tomatsås
- spaghetti
Skrivmateriel
```
Trevligt och enkelt! Du kan hitta annan syntax för Markdown [här](https://daringfireball.net/projects/markdown/syntax).
### Så vad betyder detta för mig?
Många LaTeX-användare är nöjda med sina vackert sättade LaTeX-dokument, men kan inte låta bli att känna en liten avund mot Markdown-användare—eftersom, tja, LaTeX-markup *kan* kan bli ganska omständlig ibland. Ja, listor, vi tittar på *er*...
Den goda nyheten är att det fantastiska nya [`markdown` LaTeX-paketet](https://ctan.org/pkg/markdown) låter dig skriva markdown-syntax i dina LaTeX-dokument (dvs. enklare indata) och ändå få vackert sättade PDF-filer! Allt du behöver göra är att ladda `markdown` paketet i ditt dokument och omsluta ditt Markdown-material inom en `markdown` miljön:
```latex
\documentclass{article}
\usepackage{markdown}
\begin{document}
\begin{markdown}
# Inköpslista
*Kom ihåg* att ta så mycket vi kan under kommande [reor](http://acme-marg.com)!
## Mat
- bönor i tomatsås
- spaghetti
## Skrivmateriel
- skrivblock
- pennor
\end{markdown}
\end{document}
```
Eller om du föredrar att lägga ditt Markdown-material i en `*.md` fil:
```latex
\documentclass{article}
\usepackage{markdown}
\begin{document}
\markdownInput{example.md}
\end{document}
```
Snyggt! Detta kommer sannolikt att göra utvecklartyper mycket glada eftersom de nu bara kan kopiera över sin `.md` dokumentation!
### Kan jag fortfarande använda LaTeX-kommandon om jag skriver Markdown?
Ja, du kan fortfarande använda LaTeX-kommandon i ditt Markdown-material! Skicka bara `hybrid` alternativet till `markdown`:
```latex
\usepackage[hybrid]{markdown}
...
- skrivblock (typen med det stora $E=mc^2$ på omslaget)
```
### Hur kan jag använda bokstavliga tecken som '#' och '\_' (understreck)?
#### Att skriva ett '#'
Du kan inte skriva tecknet '#' *inuti `markdown` miljön*. Inte ens `\#` fungerar. Du behöver definiera ett kommando som `\newcommand{\texthash}{\#}`, och sedan använda `\texthash` i dina `markdown` miljön. Detsamma gäller understreck, särskilt när det finns fler än ett på samma rad, t.ex. `$y = m_1 + n_2$`. Ibland kan det vara enklare att avsluta den aktuella `markdown` miljön och skriva problematiska rader i vanligt LaTeX-läge, och sedan starta en annan `markdown` miljön.
#### Att skriva '\_' (understreck) och '\`' (backtick)
**Uppdatering** (tillägg 13 maj 2017): Sedan `markdown` version 2.5 kan du ställa in `underscores = false` och `codeSpans = false` för att inaktivera understreck och backticks. Detta gör det möjligt att skriva matematiska index och citationstecken i hybridläge utan att behöva escape:a. Vi har asterisker för betoning, så det enda som egentligen går förlorat är inline-kodexempel. Tack Vít för tipset!
#### Miljöer att undvika...
Och även om du kan använda backticks för att skriva inline-verbatim, eller indentera raden med fyra mellanslag för ett verbatim-block, använd inte `lstlisting` inte heller `minted` LaTeX-miljöer inom `markdown` miljöer. Gör det bara inte.
#### Använda HTML i en markdown-miljö
Och nej, du kan inte använda HTML inuti LaTeX `markdown` miljön (även om detta är vanligt i vanlig Markdown). Tyvärr.
**Uppdatering** (tillägg 13 maj 2017): Från och med `markdown` v2.3 finns det en `html` inställning som inte visar HTML-taggar ordagrant om de finns i ditt markdown-material, men som inte heller faktiskt formaterar taggens innehåll—dvs. `Hej!` kommer bara att visa Hej! i normal stil. Men HTML-entiteter som `©` kommer att återges som ©. Tack till Vít för att han pekade ut detta.
### Föreslagna alternativ för markdown-paketet
En uppsättning `markdown` paketalternativ som du kan ha nytta av är:
```latex
\usepackage[footnotes,definitionLists,hashEnumerators,smartEllipses,hybrid]{markdown}
```
Dessa alternativ aktiverar användningen av
* markdown-syntax för fotnoter (som `[^1]`);
* definitionslistor och `#` för numrerade listor;
* "riktiga" ellipser (…).
Här är ett [fullständigt exempel](https://www.overleaf.com/latex/examples/using-markdown-in-latex-documents/whdrnpcpnwrm) i Overleaf-galleriet, och här är [ett till](https://www.overleaf.com/articles/how-to-write-using-rich-text-format-and-markdown-in-latex-and-overleaf/dbqrxvftzskw).
### Hyperlänkar och fotnoter: hur?
I Overleaf-exemplet är hyperlänken en fotnot. Hur får jag den att bli en hyperref-hyperlänk?
`markdown` är anpassningsbart, så du kan definiera hur du vill att olika element ska återges. Att lägga till dessa i din preamble gör just det:
```latex
\markdownSetup{renderers={
link = {\href{#2}{#1}}
}}
```
**Uppdatering** (tillägg 13 maj 2017): `rendererPrototypes` användes i den första versionen. Vanliga användare rekommenderas att använda `renderers` för sina egna definitioner, eftersom `rendererPrototypes` finns där för paketskapares standardinställningar. Om du ändrar `rendererPrototypes`, riskerar du att ett annat paket kan åsidosätta dina inställningar. Tack till Vít för att han pekade ut detta!
### Infoga bilder (uppdaterad 8 november 2022)
* **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
```
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}
\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:
#### 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.
#### Ändra float-placeringsidentifierare (mer avancerat)
Markdown-syntaxen för att inkludera figurer tillåter inte att du direkt anger float-placeringsidentifierarna, men du kan justera dem genom att omdefiniera hur figuren återges:
```latex
\markdownSetup{renderers={
image = {\begin{figure}[hbt!]
\centering
\includegraphics{#3}%
\ifx\empty#4\empty\else
\caption{#4}%
\fi
\end{figure}}
}}
```
För mer information, se [markdown-dokumentationen](https://mirror.apps.cam.ac.uk/pub/tex-archive/macros/generic/markdown/markdown.html).
### Kan du skapa tabeller med markdown i LaTeX? 😀
Tyvärr inte. Tabeller stöds endast i [MultiMarkdown](http://fletcherpenney.net/multimarkdown/) endast, och LaTeX- `markdown` paketet har för närvarande inget stöd för det.
**Uppdatering** (tillägg 13 maj 2017): Baserat på ett tips från Vít är det möjligt att använda `contentBlocks` syntaxutvidgningen sedan version 2.4, eller justera `inputFencedCode` renderern, för att snabbt omvandla viss CSV-lik text till en tabell.
### Fler trevligheter med markdown-paketet...?
Som nämnts tidigare är det ett coolt sätt att ta anteckningar, och när det kombineras med några trevliga LaTeX-dokumentklasser eller paketinställningar kan du ha en vacker anteckningsbok redan i slutet av själva föreläsningen. Du skulle till exempel kunna använda det tillsammans med [Tufte-klasserna](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}
```
Och den korta och enkla syntaxen som gör det mycket smidigare att skriva listor betyder att vi nu har en *verkligen snabb* metod för att skriva [Beamer-presentationer](https://www.overleaf.com/latex/examples/writing-beamer-slides-with-markdown/dnrwnjrpjjhw) och [affischer](https://www.overleaf.com/latex/examples/writing-beamer-slides-with-markdown/dnrwnjrpjjhw)!
Ha kul!
---
# 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/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.