{"canonical_url":"https://engineer.company/sv/glossary/gemtext/","content_markdown":"# Gemtext\n\n## Vad det är\n\nGemtext är dokumentformatet i protokollet Gemini: vanlig text i UTF-8 där de första tecknen på\nvarje rad avgör vad raden är, så att en klient kan rendera en hel sida i ett enda svep uppifrån och\nned. Specifikationen kallar det Geminis hypertextformat, servrar märker det med medietypen\n`text/gemini` och filerna slutar enligt konvention på `.gmi`.\n\nDet finns sex sorters rader. En rad som börjar med `=\u003e` är en länk, med en adress, absolut eller\nrelativ, och en valfri etikett efter den. En rad med tre backticks slår på eller av förformaterat\nläge, och allt som står mellan två sådana rader visas exakt som det skrevs, i ett typsnitt med fast\nbredd. En, två eller tre brädgårdar gör en rubrik, en asterisk följd av ett mellanslag gör en\nlistpunkt och en rad som börjar med `\u003e` blir ett citat. Alla andra rader är vanlig text, och\nklienten radbryter dem efter bredden på den skärm de hamnar på.\n\n```text\n# Field notes\n\nA text line is a paragraph, however long it runs. The client wraps it.\n\n=\u003e /archive/ Older notes\n=\u003e gemini://example.org/ A capsule elsewhere\n\n* A list item\n\u003e A quoted line\n```\n\nSpecifikationen delar in de sex i tre kärntyper som varje klient måste hantera (text, länkar och\nväxeln för förformaterat läge) och tre som en minimal klient får visa som vanlig text. Det är hela\nformatet. Det saknar fetstil, kursiv, tabeller, bilder i löptexten och nästling, och det går inte\natt göra ett ord mitt i en mening klickbart. En parser håller reda på en enda bit tillstånd: om den\nbefinner sig i ett förformaterat block eller inte.\n\nGemtext jämförs oftast med Markdown, som det liknar vid första anblick. Skillnaden ligger i vad de\när till för. En Markdown-fil är en källfil, skriven för att omvandlas till något annat. En\ngemtext-fil är redan det färdiga dokumentet, och läsarens klient är den enda som renderar det. Sin\nenda strukturella vana, länken på en egen rad, har formatet lånat från de äldre menyerna i Gopher.\n\n## Varför det spelar roll\n\nAtt välja gemtext är att välja vem som styr sidan. Författaren bestämmer strukturen: vilka rader som\när rubriker, vilka som är länkar och var koden står. Läsarens klient bestämmer resten, från typsnitt\noch radlängd till färg, avstånd och om rubrikerna blir en innehållsförteckning. Specifikationen\nsäger rakt ut att formatet inte är tänkt att ge författare exakt kontroll över presentationen. För\nen del utgivare är det en lättnad, och för andra är frågan därmed avgjord. Det lönar sig att veta\nvilket innan man konverterar en enda sida.\n\nLättnaden ligger i det som försvinner. En sida i gemtext bär ingen stilmall, inget skript, inget\nwebbtypsnitt, ingen fråga om samtycke till kakor och ingen spårningspixel, och det enda som\nnågonsin behöver uppdateras är orden. Sidorna blir små och går snabbt att skriva för hand. Länkar\nhämtar aldrig något på egen hand, eftersom specifikationen förbjuder en klient att öppna en\nnätverksanslutning bara för att visa en länk. En sida kan alltså inte dra in en bild eller ett\ntypsnitt från tredje part bakom läsarens rygg.\n\nKostnaden är lika konkret. Gemtext når bara de som kör en Gemini-klient, och det är en liten publik\njämfört med webbens. Formatet har inga formulär: det enda sätt en kapsel kan be om inmatning är en\nstatuskod i protokollet, aldrig något i dokumentet. Och prosan måste fungera utan länkar inne i\nmeningarna. En mening skriven för HTML, ”se prissidan för detaljer”, behåller sina ord men tappar\nsin pekare. Att skriva bra gemtext är därför att skriva meningar som fortfarande går att förstå när\nlänken står på raden under.\n\nDärför gäller den realistiska frågan för de flesta organisationer gemtext utöver en webbplats, inte\ngemtext i stället för en, framställt från samma källa av samma bygge. Ställd på det sättet kostar\ngemtext lite att lägga till, och det fungerar samtidigt som ett test av texten. Läses en sida\nfortfarande tydligt som en kolumn av textrader och länkrader, så satt strukturen i orden hela tiden.\n\n## Så ser det ut i praktiken\n\nDen här webbplatsen publiceras som gemtext vid sidan av sin HTML. Sidan\n[Engineer i en terminal](/sv/cli/) anger kapselns adress, `gemini://engineer.company/`, säger att\nvarje sida på webbplatsen också finns i formatet och nämner klienter som läser det: Amfora,\nLagrange och Bombadillo i en terminal, Castor och Kristall i ett fönster. Den ger också skälet. En\ndriftsättning skriver en mapp som varje ytterdörr läser, så kopian i gemtext kan inte glida isär\nfrån HTML-koden, och en sida som läses bra som gemtext är en sida vars struktur är verklig snarare\nän pålagd.\n\nHur det byggdes står i [redogörelsen för hur webbplatsen speglades till Gemini\noch Gopher](/sv/portfolio/mirrored-the-site-to-gemini-and-gopher/). Gemtext är\nett utdataformat i samma bygge, inte en separat verktygskedja.\nWebbplatsgeneratorn fick egna medietyper och utdataformat, och varje sida,\nsektion och taxonomiterm fick ett Gemini-dokument vid sidan av sin HTML och sin\nMarkdown-tvilling: 777 stycken i det dokumenterade implementeringsskedet,\nserverade av en liten daemon på samma värddator. De nya formaten är markerade\nsom icke-alternativa representationer. En separat jämförelse av byggen mätte\nnoll ändrade HTML-byte när formaten lades till; den mätte inte senare\nredaktionella eller visuella ändringar.\n\nMallarna bakom den kopian visar vad en konvertering till gemtext innebär. Varje länk inne i en\nmening lyfts ut: orden stannar där meningen behöver dem, och adressen flyttar ned under texten som\nen egen `=\u003e`-rad. Markeringar för fetstil tas bort, punkter med bindestreck blir asterisker, och ett\nkodblock mellan tre backticks passerar orört, eftersom Markdown och gemtext ramar in sådana block\nmed samma tre tecken.\n\n## Var det går fel\n\n### Halva rader som aldrig fogas ihop\n\nProsan kommer fram i klienten som en ojämn kolumn av korta rader, brutna mitt i en sats. Källan var\nhårt radbruten vid 80 kolumner, som Markdown-filer ofta är, och specifikationen förbjuder en klient\natt foga ihop korta textrader som följer på varandra till längre. Skriv varje stycke som en enda\nlång rad, eller låt konverteraren foga ihop mjuka radbrytningar innan den skriver filen.\n\n### Länkar som lämnar kapseln\n\nDen första länken en läsare följer öppnar en webbläsare. Konverteraren skrev varje länk som en\nabsolut `https://`-adress, och en Gemini-klient lämnar över sådana adresser till ett annat program.\nSkriv navigeringen som sökvägar från roten, t.ex. `/about/`, som tolkas relativt till kapselns adress, och\nbehåll en avsiktlig länk per sida till sidans webbversion.\n\n### Kod som faller ihop till en enda rad\n\nEtt kodexempel visas som en enda lång rad som sitter fast i sin inledande rad med backticks.\nKonverteraren behandlade blocket som prosa och fogade ihop dess rader med allt annat. Dela upp\ndokumentet vid kodblockens gränser före alla andra steg, släpp igenom varje förformaterat block\nprecis som det skrevs och låt växelraden bära högst en kort alternativtext, t.ex. språkets namn.\n\n### Markdown som blir till bokstavliga tecken\n\nPunkter med bindestreck, dubbla asterisker, understrukna rubriker, nästlade listor och länkar inom\nhakparenteser dyker upp i klienten exakt som de skrevs. Gemtext känner bara igen en asterisk och\nett mellanslag som listpunkt och brädgårdar som rubrik, och formatet har ingen markering alls inne\ni löptexten. Konvertera de konstruktionerna på vägen ut, eller skriv kapseln direkt i gemtext.\n\n### Meningar som pekar på ingenting\n\nEtt stycke säger ”klicka här” eller ”som länkas ovan”, och läsaren har ingen aning om vart det\nleder. Länken lyftes ut ur meningen, och orden som blev kvar sa aldrig vart den gick. Skriv\nlänketiketter som namnger sitt mål, så att både meningen och `=\u003e`-raden går att förstå var för sig.\n\n## Läs mer\n\n- [A quick introduction to gemtext markup](https://geminiprotocol.net/docs/gemtext.gmi)\n  — projektets egen korta genomgång av varje radtyp, med anteckningar för den som kan Markdown.\n- [Gemini hypertext format specification](https://geminiprotocol.net/docs/gemtext-specification.gmi)\n  — den normativa texten: radtyper, parserns tillstånd, regler för radbrytning, parametern `lang`\n  och en formell grammatik.\n- [Gemini network protocol specification](https://geminiprotocol.net/docs/protocol-specification.gmi)\n  — hur en kapsel serverar gemtext: förfrågningar, statuskoder och de regler för TLS som en klient\n  följer.\n- [Project Gemini FAQ](https://geminiprotocol.net/docs/faq.gmi) — resonemanget bakom designen,\n  bl.a. varför länkar står på egna rader.\n\n\u003chttps://engineer.company/sv/glossary/gemtext/\u003e\n","date_modified":"2026-11-12T05:34:23Z","description":"Hur en sida i gemtext skrivs rad för rad, varför formatet lämnar utseendet åt läsarens klient, och var vanor från Markdown slår sönder en Gemini-kapsel.","formats":{"gemtext":"https://engineer.company/sv/glossary/gemtext/index.gmi","gopher":"https://engineer.company/sv/glossary/gemtext/gophermap","html":"https://engineer.company/sv/glossary/gemtext/","json":"https://engineer.company/sv/glossary/gemtext/index.json","markdown":"https://engineer.company/sv/glossary/gemtext/index.md","pdf":"https://engineer.company/sv/glossary/gemtext/index.pdf"},"kind":"page","language":"sv","title":"Vad är gemtext?","url":"https://engineer.company/sv/glossary/gemtext/","version":1}