> 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/dybdeartikler/30-how-to-write-in-markdown-on-overleaf.md).
# Hvordan skrive i Markdown i Overleaf
**Oppdatering etter publisering** (lagt til 13. mai 2017): Vi er takknemlige overfor Vít Novotný, forfatteren/vedlikeholderen av `markdown` pakken, for at han skrev til oss med noen nyttige tilbakemeldinger om den opprinnelige artikkelen. Vi er glade for å publisere denne oppdaterte versjonen, som tar hensyn til og inkluderer hans råd og forslag.
### Hæ, hva?
[Markdown](https://kirkstrobeck.github.io/whatismarkdown.com/) er et lettvekts oppmerkingsspråk (skjønner du? 😉) som lar deg skrive noe i ren tekst med noen *svært* enkle regler, og deretter gjøre det om til formaterte utdata, f.eks. HTML. Det er veldig populært blant programvareutviklere og programmerere, nettopp på grunn av sin enkelhet (og kan jeg tilføye, perfekt for notatskriving også!).
For eksempel, for å skrive en rask handleliste:
```
# Dagligvareliste
*Husk* å hente så mye vi kan under kommende [salg](http://acme-marg.com)!
## Mat
- bakte bønner
- spaghetti
## Skrivesaker
- skriveblokk
- blyanter
```
Og du vil få det som HTML-utdata, ved å bruke et verktøy som [pandoc](http://pandoc.org/):
```html
Dagligvareliste
Husk å hente så mye vi kan under kommende salg!
Mat
Skrivesaker
```
Fint og enkelt! Du kan finne annen syntaks for Markdown [her](https://daringfireball.net/projects/markdown/syntax).
### Så hva betyr dette for meg?
Mange LaTeX-brukere er fornøyde med sine vakre LaTeX-typede dokumenter, men kan ikke unngå å føle et snev av misunnelse på Markdown-brukere—fordi, vel, LaTeX-oppmerking *kan* kan bli nokså ordrik til tider. Ja, lister, vi ser på *deg*...
Den gode nyheten er at den fantastiske nye [`markdown` LaTeX-pakken](https://ctan.org/pkg/markdown) lar deg skrive markdown-syntaks i LaTeX-dokumentene dine (altså enklere inndata) og likevel få vakkert typede PDF-er! Alt du trenger å gjøre er å laste inn `markdown` pakken i dokumentet ditt, og omslutte Markdown-materialet ditt med en `markdown` -miljøet:
```latex
\documentclass{article}
\usepackage{markdown}
\begin{document}
\begin{markdown}
# Dagligvareliste
*Husk* å hente så mye vi kan under kommende [salg](http://acme-marg.com)!
## Mat
- bakte bønner
- spaghetti
## Skrivesaker
- skriveblokk
- blyanter
\end{markdown}
\end{document}
```
Eller hvis du foretrekker å legge Markdown-materialet ditt i en `*.md` filen:
```latex
\documentclass{article}
\usepackage{markdown}
\begin{document}
\markdownInput{example.md}
\end{document}
```
Kult! Dette vil sannsynligvis gjøre utviklertyper veldig glade, fordi de nå bare kan kopiere over sin `.md` dokumentasjon!
### Kan jeg fortsatt bruke LaTeX-kommandoer hvis jeg skriver Markdown?
Ja, du kan fortsatt bruke LaTeX-kommandoer i Markdown-materialet ditt! Bare send `hybrid` alternativet til `markdown`:
```latex
\usepackage[hybrid]{markdown}
...
- skriveblokk (den typen med den store $E=mc^2$ på omslaget)
```
### Hvordan kan jeg bruke bokstavelige tegn som '#' og '\_' (understreker)?
#### Å skrive en '#'
Du kan ikke skrive tegnet '#' *inne i `markdown` miljøet*. Ikke engang `\#` vil fungere. Du må definere en kommando som `\newcommand{\texthash}{\#}`, og deretter bruke `\texthash` i dine `markdown` miljøet. Tilsvarende for understreker, spesielt når det er mer enn én på samme linje, f.eks. `$y = m_1 + n_2$`. Noen ganger kan det være enklere å avslutte det nåværende `markdown` miljøet og skrive problematiske linjer i vanlig LaTeX-modus, og deretter starte et nytt `markdown` -miljøet.
#### Å skrive '\_' (understrek) og '\`' (backtick)
**Oppdatering** (lagt til 13. mai 2017): Siden `markdown` versjon 2.5 kan du sette `underscores = false` og `codeSpans = false` for å deaktivere understreker og backticks. Dette gjør det mulig å skrive matematiske subskript og anførselstegn i hybridmodus uten escaping. Vi har asterisks for utheving, så det eneste som virkelig går tapt er inline kodeeksempler. Takk til Vít for tipset!
#### Miljøer som bør unngås...
Og selv om du kan bruke backticks til å skrive inline-verbatim, eller rykke inn linjen med fire mellomrom for en verbatim-blokk, ikke bruk `lstlisting` eller `minted` LaTeX-miljøer innenfor `markdown` miljøer. Bare ikke.
#### Bruke HTML i et markdown-miljø
Og nei, du kan ikke bruke HTML inne i LaTeX- `markdown` miljøet (selv om dette er vanlig å gjøre i vanlig Markdown). Beklager.
**Oppdatering** (lagt til 13. mai 2017): Fra `markdown` v2.3 finnes det en `html` innstilling som ikke vil vise HTML-tagger ordrett hvis de er til stede i Markdown-materialet ditt, selv om den heller ikke faktisk formaterer taginnholdet—dvs. `Hei!` vil bare vise Hei! i normal skriftvekt. Men HTML-entiteter som `©` vil bli gjengitt som ©. Takk til Vít for at han gjorde oppmerksom på dette.
### Foreslåtte pakkealternativer for markdown
Ett sett med `markdown` pakkealternativer du kan finne nyttig er:
```latex
\usepackage[footnotes,definitionLists,hashEnumerators,smartEllipses,hybrid]{markdown}
```
Disse alternativene muliggjør bruk av
* fotnote-Markdown-syntaks (slik som `[^1]`);
* definisjonslister og `#` for nummererte lister;
* «ordentlige» ellipse-tegn (…).
Her er et [fullstendig eksempel](https://www.overleaf.com/latex/examples/using-markdown-in-latex-documents/whdrnpcpnwrm) i Overleaf-galleriet, og her er [et til](https://www.overleaf.com/articles/how-to-write-using-rich-text-format-and-markdown-in-latex-and-overleaf/dbqrxvftzskw).
### Hyperkoblinger og fotnoter: hvordan?
I Overleaf-eksemplet er hyperkoblingen en fotnote. Hvordan får jeg den til å være en hyperref-hyperkobling?
`markdown` er tilpasningsbar, så du kan definere hvordan du ønsker at ulike elementer skal gjengis. Hvis du legger disse til i preamblen din, gjør du nettopp det:
```latex
\markdownSetup{renderers={
link = {\href{#2}{#1}}
}}
```
**Oppdatering** (lagt til 13. mai 2017): `rendererPrototypes` ble brukt i den opprinnelige versjonen. Vanlige brukere anbefales å bruke `renderers` for sine egne definisjoner, ettersom `rendererPrototypes` er der for at pakkeskapere skal kunne tilby standardverdier. Hvis du endrer `rendererPrototypes`, risikerer du at en annen pakke kan overstyre innstillingene dine. Takk til Vít for at han gjorde oppmerksom på dette!
### Inkludering av bilder (oppdatert 8. november 2022)
* **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
```
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}
\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:
#### 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.
#### Endring av identifikatorer for plassering av flytende objekter (mer avansert)
Markdown-syntaksen for å inkludere figurer lar deg ikke direkte angi identifikatorene for plassering av flytende objekter, men du kan justere dem ved å redefinere hvordan figuren gjengis:
```latex
\markdownSetup{renderers={
image = {\begin{figure}[hbt!]
\centering
\includegraphics{#3}%
\ifx\empty#4\empty\else
\caption{#4}%
\fi
\end{figure}}
}}
```
For mer informasjon, se [markdown-dokumentasjonen](https://mirror.apps.cam.ac.uk/pub/tex-archive/macros/generic/markdown/markdown.html).
### Kan du lage tabeller ved å bruke markdown i LaTeX? 😀
Dessverre ikke. Tabeller støttes i [MultiMarkdown](http://fletcherpenney.net/multimarkdown/) bare, og LaTeX- `markdown` pakken har ingen støtte for det per i dag.
**Oppdatering** (lagt til 13. mai 2017): Basert på et tips fra Vít er det mulig å bruke `contentBlocks` syntaksutvidelsen siden versjon 2.4, eller justere `inputFencedCode` gjengiveren, for raskt å gjøre litt CSV-lignende tekst om til en tabell.
### Flere godbiter i markdown-pakken...?
Som nevnt tidligere er det en kul måte å ta notater på, og når det kombineres med noen fine LaTeX-dokumentklasser eller pakkesett, lar det deg ha en vakker notatbok ved slutten av selve forelesningen. For eksempel kan du bruke det med [Tufte-klassene](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 syntaksen som gjør det mye mer praktisk å skrive lister, betyr at vi nå har en *virkelig rask* måte å skrive [Beamer-presentasjoner](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)!
Ha det gøy!
---
# 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/dybdeartikler/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.