{"canonical_url":"https://engineer.company/da/glossary/markdown/","content_markdown":"# Markdown\n\n## Hvad det er\n\nMarkdown er en måde at skrive et dokument på som en almindelig tekstfil, hvor en\nhåndfuld indtastede konventioner fortæller et konverteringsprogram, hvilken HTML\ndet skal lave: stjerner om et ord for fremhævelse, en havelåge foran en\noverskrift, en bindestreg foran hvert punkt i en liste og firkantede parenteser\nefterfulgt af runde parenteser for et link. Navnet dækker både syntaksen og det\nprogram, den først kom som, filerne ender som regel på `.md` eller `.markdown`,\nog de dialekter, der er vokset ud af den, blandt dem CommonMark og GitHub\nFlavored Markdown (GFM), går alle under samme navn.\n\nJohn Gruber udviklede den i 2004 i samarbejde med Aaron Swartz og skrev den\nførste konverter i Perl; den sidste udgave, Markdown 1.0.1, er dateret 17.\ndecember 2004. Hans erklærede mål var læsbarhed frem for alt: et\nMarkdown-dokument skulle kunne udgives, som det er, som ren tekst, uden at se\nud, som om nogen havde mærket det op med tags eller formateringsinstruktioner.\nDen største enkelte inspiration til syntaksen var ifølge ham den måde, folk\nallerede formaterede e-mails i ren tekst på. Alt det, syntaksen ikke dækker,\nskrives som HTML midt i teksten, uden at skifte format eller indsætte en afgrænsning, for i\nhans optik er Markdown et skriveformat og HTML udgivelsesformatet.\n\nEt par linjer viser det meste:\n\n```markdown\nFlytningen tog **én aften**, i tre trin:\n\n- stop skrivningerne\n- kopiér dataene med `pg_dump`\n- peg [applikationen](https://example.com/app/) mod den nye vært\n```\n\nEn konverter gør det til et afsnit med et `strong`-element, en liste med tre\npunkter, et kodeudsnit og et link, og kilden kan stadig læses som en note, nogen\nhar tastet.\n\n## Hvorfor det betyder noget\n\nKilden er dokumentet, og ren tekst overlever alle værktøjerne omkring den. En\nMarkdown-fil kan åbnes i enhver editor, sammenlignes linje for linje i\nversionsstyring og gennemgås uden besvær i en pull request. Ingen leverandør kan\nnedlægge formatet, og at flytte en mængde tekst fra ét system til et andet er et\nspørgsmål om at kopiere filer.\n\nPrisen er tvetydighed. CommonMark-projektet siger det ligeud: Grubers\nbeskrivelse fastlægger ikke syntaksen entydigt, og hans script havde fejl og\nblev sidst opdateret i december 2004, så i 2014 fandtes der dusinvis af\nimplementeringer, der hver udfyldte hullerne på sin egen måde. Projektets\neksempel er et dokument, der vises på én måde i en GitHub-wiki og på en anden,\nnår Pandoc konverterer det til DocBook. Og fordi intet i Markdown regnes for en\nsyntaksfejl, viser en afvigelse sig først, når nogen kigger på resultatet.\nProjektet henviser til Babelmark 3, som kører samme input gennem mere end tyve\nimplementeringer for at se, om de er enige.\n\nCommonMark, som blev sat i gang i 2014, svarer med en specifikation skrevet af\nJohn MacFarlane, der binder hver regel til eksempler på input og den præcise\nHTML, de skal give: 652 af dem i version 0.31.2, dateret 28. januar 2024. GitHub\ndefinerer sin egen dialekt, GFM, som et strengt supersæt af CommonMark og lægger\ntabeller, opgavelister, gennemstregning, udvidede autolinks og et filter, der\nuskadeliggør en kort liste af rå HTML-tags, oveni. Hugos Markdown-konverter,\nGoldmark, overholder CommonMark-specifikationen og er kompatibel med GFM.\n\nMarkdown har også et navn på nettet. Siden marts 2016 har RFC 7763 registreret\n`text/markdown` for hele familien af syntakser, med en krævet\n`charset`-parameter og en valgfri `variant`-parameter, der siger, hvilken\ndialekt en fil er skrevet i.\n\n## Sådan ser det ud i praksis\n\nDette sites håndskrevne sider er Markdown, sat op af Go-skabeloner.\n[Kolofonen nævner begge](/da/credits/) blandt de værktøjer, siderne bliver til\nmed, ved siden af Hugo, den statiske sitegenerator. Samme side nævner\nmarkdownlint blandt de lintere, der holder kilden ærlig, i en kvalitetsport,\nhvor enhver meddelelse fra et værktøj tæller som en fejl.\n\n[Siden om at være klar til AI-agenter](/da/ai-ready/) vender formatet om: hver\nside her har en Markdown-tvilling på samme adresse, som man når ved at tilføje\n`index.md` eller ved at bede om `text/markdown`, og kvalitetsporten gennemgår\nhver tvilling for efterladt markup og stopper udgivelsen, hvis en af dem ikke\nholder. Tvillingen til netop den side er én forespørgsel væk:\n\n```sh\ncurl -sL https://engineer.company/da/ai-ready/index.md\n```\n\n[Omkring 50.000 ord softwaredokumentation](/da/portfolio/wrote-50000-words-of-software-documentation/)\nblev skrevet i Markdown i GitHub, Craft og Confluence, en stor del af den i\nhånden. Den rummede arkitekturen, processerne og de praktiske vejledninger, folk\nellers spurgte om igen og igen; den lå under versionsstyring og var nem at\nfinde, og nye folk kom hurtigere i gang.\n\n## Hvor det går galt\n\n**Fed skrift vises som stjerner.** En læser ser to stjerner på hver side af et\nord, der skulle have været fed, og alle tjek forbliver grønne, fordi HTML'en er\ngyldig, og linkene stadig virker. CommonMark åbner kun fremhævelse på en\nvenstreflankerende række af stjerner, og en række, der efterfølges af\ntegnsætning, som den firkantede parentes i et link, tæller kun, når der står\nmellemrum eller tegnsætning foran den. Et bogstav foran holder stjernerne\nbogstavelige, og det samme gør alt, hvad en skabelonmotor sætter der, før\nMarkdown bliver parset: Hugo erstatter en shortcode med en pladsholder af\nbogstaver og cifre. Dette sites skabelon til Markdown-tvillingerne noterer, at\nda mellemrummet mellem en shortcode og den fede tekst ved siden af blev fjernet,\ngik den fede skrift i stykker på 60 punkter på tværs af tre sprog. Behold\nmellemrummet, og tjek den viste side frem for kilden; dette sites kvalitetsport\nhar et tjek, der læser den byggede HTML for Markdown, som nåede frem til en\nlæser som tegnsætning.\n\n**Den samme fil vises på to måder.** En indlejret liste bliver flad i ét system\nog forbliver indlejret i et andet, eller en havelåge først på en linje giver en\noverskrift i én konverter og forbliver tekst i den næste, og intet melder det,\nfordi Markdown ikke har syntaksfejl at melde. Årsagen er en forskel i dialekt:\nto konvertere, der udfylder et af de oprindelige huller på hver sin måde.\nNavngiv den dialekt, et projekt skrives i, i de fleste tilfælde CommonMark eller\nGFM, brug en linter, der holder filerne til den, og kør tvivlsomt input gennem\nmere end én implementering, før du stoler på det.\n\n**Markdown-udgaven af en side indeholder HTML.** En læser af tekstudgaven møder\nrå `svg`-elementer eller et telefonnummer, der begynder med en numerisk\ntegnreference, hvor plustegnet skulle have stået. En komponent, der skriver HTML\ntil websiden, skriver den samme HTML ind i alle andre formater, medmindre den\nfår besked på andet; Hugo slår en shortcodes skabelon op pr. outputformat og\nfalder tilbage på HTML-skabelonen. Dette sites shortcode-skabeloner noterer\nbegge tilfælde, 49 rå `svg`-elementer i Markdown-udgaven af kolofonen og\nkontaktsidens nummer escapet til HTML, og en shortcode, der skriver nogen form\nfor markup, har nu sin egen skabelon til Markdown-outputtet. Kvalitetsporten\ntjekker også, at Markdown-tvillingerne er fri for rå HTML og HTML-entiteter, og\nspringer kode over.\n\n**Rå HTML forsvinder fra siden.** En blok HTML, der er skrevet ind i Markdown,\nmangler på den byggede side, og kilden ser fin ud. Grubers syntaks lader HTML\nstå hvor som helst i teksten, men en konverter må gerne afvise den: Hugos\n`unsafe`-indstilling for Goldmark er slået fra som standard, så rå HTML blandet\nind i Markdown bliver ikke gengivet, og GFM escaper en kort liste af tags som\n`script` og `iframe`, så de vises som tekst. Brug i stedet det, generatoren\ntilbyder, i Hugo en shortcode eller en\n[render hook](https://gohugo.io/render-hooks/), eller slå indstillingen til med\nvilje og accepter det, den lukker igennem.\n\n**Linteren godkender det, den blev bedt om at overse.** En Markdown-fil med en\ndefekt struktur slipper igennem gennemgangen, fordi markdownlint ikke melder\nnoget. De regler, der ville have fanget det, var slået fra i konfigurationen,\nuden at nogen havde skrevet en begrundelse. Dette sites udviklingsregler\nnoterer, at markdownlint engang lå i en JSON-fil med seks regler slået fra og\ningen kommentarer, og at to af de seks skjulte rigtige fejl, da de blev målt.\nSkriv begrundelsen ved hver regel, der er slået fra, i et format, der kan rumme\nen kommentar, så den næste kan være uenig i den.\n\n## Læs mere\n\n- [CommonMark Spec](https://spec.commonmark.org/) — specifikationen regel for\n  regel, hver bundet til eksempler på input og den HTML, de skal give.\n- [CommonMark](https://commonmark.org/) — hvorfor der var brug for en\n  specifikation, hvordan implementeringerne gled fra hinanden, og hvem der\n  vedligeholder den.\n- [Markdown, by John Gruber](https://daringfireball.net/projects/markdown/) —\n  den oprindelige beskrivelse, designmålet og Perl-scriptet.\n- [Markdown: Syntax](https://daringfireball.net/projects/markdown/syntax) —\n  Grubers egen gennemgang af syntaksen, med reglen for HTML inde i teksten.\n- [GitHub Flavored Markdown Spec](https://github.github.com/gfm/) — GitHubs\n  dialekt som et supersæt af CommonMark, med hver udvidelse markeret.\n- [RFC 7763: The text/markdown Media Type](https://www.rfc-editor.org/rfc/rfc7763)\n  — medietypen, dens krævede `charset` og dens `variant`-parameter.\n\n\u003chttps://engineer.company/da/glossary/markdown/\u003e\n","date_modified":"2026-11-12T05:34:23Z","description":"Hvor Markdown kom fra, hvorfor én fil kan blive vist på to måder, hvordan CommonMark låser syntaksen fast, og fejlene der viser stjerner som tekst.","formats":{"gemtext":"https://engineer.company/da/glossary/markdown/index.gmi","gopher":"https://engineer.company/da/glossary/markdown/gophermap","html":"https://engineer.company/da/glossary/markdown/","json":"https://engineer.company/da/glossary/markdown/index.json","markdown":"https://engineer.company/da/glossary/markdown/index.md","pdf":"https://engineer.company/da/glossary/markdown/index.pdf"},"kind":"page","language":"da","title":"Hvad er Markdown?","url":"https://engineer.company/da/glossary/markdown/","version":1}