{"canonical_url":"https://engineer.company/sv/glossary/markdown/","content_markdown":"# Markdown\n\n## Vad det är\n\nMarkdown är ett sätt att skriva ett dokument som en vanlig textfil, där några få inskrivna\nkonventioner talar om för en konverterare vilken HTML den ska ta fram. Asterisker runt ett ord ger\nbetoning, en brädgård före en rad gör den till rubrik, ett bindestreck inleder varje punkt i en\nlista, och hakparenteser följda av vanliga parenteser blir en länk. Namnet står både för syntaxen\noch för programmet den först levererades som. Filerna slutar oftast på `.md` eller `.markdown`, och\ndialekterna som vuxit fram ur den, bl.a. CommonMark och GitHub Flavored Markdown (GFM), går alla\ntillbaka på den.\n\nJohn Gruber tog fram Markdown 2004 i samarbete med Aaron Swartz och skrev den första konverteraren i\nPerl. Den sista versionen, Markdown 1.0.1, är daterad den 17 december 2004. Hans uttalade mål var\nläsbarhet framför allt: ett Markdown-dokument ska kunna publiceras som det är, som ren text, utan\natt se ut som om det märkts upp med taggar eller formateringsinstruktioner. Den enskilt största\nförebilden för syntaxen var, skrev han, hur folk redan formaterade e-post i ren text. Det som\nsyntaxen inte täcker skrivs som HTML mitt i texten, utan någon växel eller avgränsare, eftersom\nMarkdown i hans synsätt är ett skrivformat och HTML ett publiceringsformat.\n\nNågra rader visar det mesta:\n\n```markdown\nFlytten tog **en kväll**, i tre steg:\n\n- stoppa skrivningarna\n- kopiera data med `pg_dump`\n- peka [applikationen](https://example.com/app/) mot den nya värden\n```\n\nEn konverterare gör om det till ett stycke med ett `strong`-element, en lista med tre punkter, ett\nkodfragment och en länk, och källtexten läses fortfarande som en anteckning som någon har skrivit.\n\n## Varför det spelar roll\n\nKällan är dokumentet, och ren text överlever alla verktyg runt omkring den. En Markdown-fil öppnas i\nvilken editor som helst, jämförs rad för rad i versionshanteringen och går lätt att granska i en\npull request. Formatet hör inte till en leverantör som kan lägga ned det, och att flytta en mängd\ntext från ett system till ett annat handlar om att kopiera filer.\n\nPriset är tvetydighet. CommonMark-projektet säger det rakt ut: beskrivningen från Gruber anger inte\nsyntaxen entydigt, och hans skript hade buggar och uppdaterades senast i december 2004. År 2014\nfanns därför dussintals implementationer, och var och en fyllde luckorna på sitt eget sätt.\nProjektets exempel är ett dokument som visas på ett sätt i en wiki på GitHub och på ett annat när\ndet konverteras till DocBook med Pandoc. Eftersom ingenting i Markdown räknas som ett syntaxfel\nmärks en avvikelse först när någon tittar på resultatet. Projektet hänvisar till Babelmark 3, som\nkör samma indata genom fler än tjugo implementationer för att se om de är överens.\n\nCommonMark, som startade 2014, svarar med en specifikation skriven av John MacFarlane som knyter\nvarje regel till exempel på indata och den exakta HTML som ska komma ut. I version 0.31.2, daterad\nden 28 januari 2024, är exemplen 652 till antalet. GitHub definierar sin egen dialekt, GFM, som en\nstrikt övermängd av CommonMark och lägger till tabeller, uppgiftslistor, genomstruken text, utökade\nautolänkar och ett filter som oskadliggör en kort lista med råa HTML-taggar. Konverteraren i Hugo,\nGoldmark, följer CommonMark-specifikationen och är kompatibel med GFM.\n\nMarkdown har också ett namn i trafiken mellan program. Sedan mars 2016 registrerar RFC 7763\nmediatypen `text/markdown` för hela familjen av syntaxer, med en obligatorisk parameter `charset`\noch en valfri parameter `variant` som anger vilken dialekt en fil är skriven i.\n\n## Så ser det ut i praktiken\n\nDe handskrivna sidorna på den här webbplatsen är Markdown som läggs ut med mallar i Go, och\n[sidan med medverkande verktyg](/sv/credits/) räknar upp båda bland verktygen som sidorna görs med,\nbredvid Hugo, som är webbplatsens statiska webbplatsgenerator. Samma sida nämner markdownlint bland\nde linters som håller källtexten ärlig, i en kvalitetsgrind där varje anmärkning räknas som ett fel.\n\n[Sidan om att vara redo för AI-agenter](/sv/ai-ready/) vänder på formatet. Varje sida här har en\nMarkdown-tvilling på samma adress, som nås genom att lägga till `index.md` eller genom att be om\n`text/markdown`, och bygget läser varje tvilling efter kvarlämnad markup och vägrar publicera när\nnågon är fel. Tvillingen till den sidan finns en begäran bort:\n\n```sh\ncurl -sL https://engineer.company/ai-ready/index.md\n```\n\n[Runt 50 000 ord programvarudokumentation](/sv/portfolio/wrote-50000-words-of-software-documentation/)\nskrevs i Markdown i GitHub, Craft och Confluence, mycket av det för hand. Texterna täckte\narkitekturen, processerna och det praktiska instruktionsmaterialet som folk frågade efter om och om\nigen. De hölls versionshanterade och lätta att hitta, och nya medarbetare kom in i arbetet snabbare.\n\n## Var det går fel\n\n**Fetstilen syns som asterisker.** Läsaren ser två asterisker på var sida om ett ord som skulle ha\nvarit fetstilt, och alla kontroller förblir gröna, eftersom HTML-koden är giltig och länkarna\nfungerar. CommonMark öppnar betoning bara vid en vänsterflankerande följd av asterisker, och en\nföljd som efterföljs av skiljetecken, t.ex. hakparentesen i en länk, räknas bara när ett blanksteg\neller ett skiljetecken står framför den. En bokstav framför gör asteriskerna bokstavliga, och det\ngör även allt som en mallmotor sätter dit innan Markdown tolkas: Hugo ersätter en shortcode med en\nplatshållare av bokstäver och siffror. Mallen för webbplatsens Markdown-tvillingar noterar att när\nblanksteget mellan en shortcode och fetstilen bredvid togs bort, gick fetstilen sönder i 60 punkter\npå tre språk. Behåll blanksteget och kontrollera den renderade sidan i stället för källan.\nWebbplatsens grind har en kontroll som läser den byggda HTML-koden efter Markdown som nådde läsaren\nsom skiljetecken.\n\n**Samma fil ser olika ut på två ställen.** En nästlad lista plattas till i ett system och nästlas i\nett annat, eller en brädgård i början av en rad blir en rubrik i en konverterare och förblir text i\nnästa, och ingenting rapporterar det, eftersom Markdown saknar syntaxfel att rapportera. Orsaken är\nen skillnad mellan dialekter: två konverterare som fyller en av de ursprungliga luckorna på olika\nsätt. Bestäm vilken dialekt ett projekt skrivs i, för det mesta CommonMark eller GFM, använd en\nlinter som håller filerna till den, och kör tveksam indata genom mer än en implementation innan ni\nförlitar er på den.\n\n**Markdown-kopian av en sida bär med sig HTML.** Den som läser textversionen möter råa\n`svg`-element, eller ett telefonnummer som börjar med en numerisk teckenreferens där plustecknet\nskulle stå. En komponent som renderar till HTML för webbsidan renderar samma HTML till alla andra\nformat om den inte får besked om något annat. Hugo slår upp mallen för en shortcode per utdataformat\noch faller tillbaka på HTML-mallen. Webbplatsens shortcode-mallar dokumenterar båda fallen, 49 råa\n`svg`-element i Markdown-kopian av sidan med medverkande verktyg och kontaktsidans nummer escapat\nför HTML, och en shortcode som skriver någon form av markup har nu en egen mall för Markdown-utdata.\nGrinden kontrollerar dessutom att Markdown-tvillingarna varken bär rå HTML eller HTML-entiteter, med\nkod undantagen.\n\n**Rå HTML försvinner från sidan.** Ett block HTML som skrivits in i Markdown-texten syns inte på den\nbyggda sidan, fast källan ser bra ut. Syntaxen från Gruber låter HTML stå var som helst i texten,\nmen en konverterare får vägra: inställningen `unsafe` för Goldmark i Hugo är avslagen som standard,\nså rå HTML blandad i Markdown renderas inte, och GFM escapar en kort lista med taggar som `script`\noch `iframe` så att de skrivs ut som text. Använd hellre det som generatorn erbjuder, en shortcode\neller en [render hook](https://gohugo.io/render-hooks/) i Hugo, eller slå på inställningen medvetet\noch acceptera det den släpper igenom.\n\n**Lintern släpper igenom det den blivit tillsagd att strunta i.** En Markdown-fil med trasig\nstruktur går igenom granskningen eftersom markdownlint inte rapporterar något. Reglerna som skulle\nha fångat felet var avslagna i konfigurationen, utan något nedskrivet skäl. Webbplatsens\nutvecklingsregler noterar att markdownlint en gång låg i en JSON-fil med sex regler avslagna och\ninga kommentarer, och att två av de sex visade sig dölja verkliga defekter när de mättes. Skriv\nskälet bredvid varje avslagen regel, i ett format som kan rymma en kommentar, så att nästa person\nkan säga emot.\n\n## Läs mer\n\n- [CommonMark Spec](https://spec.commonmark.org/) — specifikationen regel för regel, var och en\n  knuten till exempel på indata och den HTML som ska komma ut.\n- [CommonMark](https://commonmark.org/) — varför en specifikation behövdes, hur implementationerna\n  gled isär och vem som underhåller den.\n- [Markdown, by John Gruber](https://daringfireball.net/projects/markdown/) — originalbeskrivningen,\n  designmålet och skriptet i Perl.\n- [Markdown: Syntax](https://daringfireball.net/projects/markdown/syntax) — Grubers egen genomgång\n  av syntaxen, inklusive regeln för HTML i löptext.\n- [GitHub Flavored Markdown Spec](https://github.github.com/gfm/) — dialekten från GitHub som en\n  övermängd av CommonMark, med varje tillägg utmärkt.\n- [RFC 7763: The text/markdown Media Type](https://www.rfc-editor.org/rfc/rfc7763) — mediatypen, den\n  obligatoriska parametern `charset` och parametern `variant`.\n\n\u003chttps://engineer.company/sv/glossary/markdown/\u003e\n","date_modified":"2026-10-20T21:59:50Z","description":"Markdown från Gruber till CommonMark och GFM: varför samma fil kan se olika ut, hur ett dialektval görs och varför fetstil ibland syns som asterisker.","formats":{"gemtext":"https://engineer.company/sv/glossary/markdown/index.gmi","gopher":"https://engineer.company/sv/glossary/markdown/gophermap","html":"https://engineer.company/sv/glossary/markdown/","json":"https://engineer.company/sv/glossary/markdown/index.json","markdown":"https://engineer.company/sv/glossary/markdown/index.md","pdf":"https://engineer.company/sv/glossary/markdown/index.pdf"},"kind":"page","language":"sv","title":"Vad är Markdown?","url":"https://engineer.company/sv/glossary/markdown/","version":1}