{"canonical_url":"https://engineer.company/de/glossary/gemtext/","content_markdown":"# gemtext\n\n## Was es ist\n\nGemtext ist das Dokumentformat des Gemini-Protokolls: einfacher UTF-8-Text,\nbei dem die ersten Zeichen jeder Zeile deren Art bestimmen. Ein Client kann\ndadurch eine ganze Seite in einem Durchlauf von oben nach unten darstellen.\nDie Spezifikation nennt es Gemini-Hypertextformat. Server kennzeichnen es mit\ndem Medientyp `text/gemini`, die Dateien enden üblicherweise auf `.gmi`.\n\nEs gibt sechs Zeilenarten. Eine mit `=\u003e` beginnende Zeile ist ein Link aus\neiner absoluten oder relativen Adresse und einer optionalen Beschriftung\ndahinter. Eine Zeile mit drei Backticks schaltet den vorformatierten Modus\nein oder aus. Alles zwischen zwei solchen Zeilen wird genau wie geschrieben\nin einer dicktengleichen Schrift gezeigt. Ein, zwei oder drei Rautenzeichen\nbilden eine Überschrift. Ein Sternchen mit folgendem Leerzeichen bildet einen\nListeneintrag, ein Größer-als-Zeichen ein Zitat. Jede andere Zeile ist normaler\nText. Der Client bricht sie auf die Breite des jeweiligen Bildschirms um.\n\n```text\n# Feldnotizen\n\nEine Textzeile ist ein Absatz, egal wie lang. Der Client bricht sie um.\n\n=\u003e /archive/ Ältere Notizen\n=\u003e gemini://example.org/ Eine andere Kapsel\n\n* Ein Listeneintrag\n\u003e Eine zitierte Zeile\n```\n\nDie Spezifikation teilt diese sechs Arten in drei Kerntypen, die jeder Client\nverarbeiten muss: Text, Links und den Umschalter für Vorformatierung. Die\nanderen drei darf ein minimaler Client als einfachen Text darstellen.\nDas ist das ganze Format. Es hat weder Fett- noch Kursivschrift, Tabellen,\nBilder im Textfluss, Verschachtelung noch eine Möglichkeit, ein Wort mitten\nim Satz anklickbar zu machen. Ein Parser hält ein einziges Zustandsbit:\nob er sich innerhalb eines vorformatierten Blocks befindet.\n\nGemtext wird am häufigsten mit Markdown verglichen, dem es auf den ersten\nBlick ähnelt. Der Unterschied liegt im jeweiligen Zweck. Eine Markdown-Datei\nist Quelltext, der in etwas anderes umgewandelt werden soll. Eine gemtext-Datei\nist bereits das fertige Dokument. Nur der Client des Lesers stellt es dar.\nSeine eine strukturelle Gewohnheit, einen Link auf eine eigene Zeile zu setzen,\nübernimmt gemtext von den älteren Gopher-Menüs.\n\n## Warum es wichtig ist\n\nWer gemtext wählt, entscheidet, wer die Seite kontrolliert. Der Autor bestimmt\ndie Struktur: Welche Zeilen sind Überschriften, welche Links, wo steht der\nCode? Alles andere entscheidet der Client des Lesers, von Schrift und\nZeilenlänge über Farbe und Abstände bis dazu, ob die Überschriften zu einem\nInhaltsverzeichnis werden. Die Spezifikation sagt ausdrücklich, dass das\nFormat Autoren keine genaue Kontrolle über die Darstellung geben soll.\nFür manche Herausgeber ist das eine Entlastung; für andere kommt das Format\ndamit nicht infrage.\nDas klärt man besser, bevor auch nur eine Seite konvertiert wird.\n\nDie Entlastung liegt in dem, was entfällt. Eine gemtext-Seite enthält kein\nStylesheet, kein Skript, keinen Webfont, keinen Cookie-Hinweis und keinen\nZählpixel. Nur die Wörter müssen aktuell gehalten werden. Die Seiten sind\nklein und schnell von Hand geschrieben. Links laden nie von sich aus etwas.\nDie Spezifikation verbietet einem Client, allein zur Anzeige eines Links eine\nNetzwerkverbindung zu öffnen. Eine Seite kann also nicht hinter dem Rücken\ndes Lesers ein Bild oder einen Font eines Dritten nachladen.\n\nDer Preis ist ebenso konkret. Gemtext erreicht nur Menschen mit einem\nGemini-Client, ein kleines Publikum im Vergleich zum Web. Es hat keine\nFormulare. Die einzige Möglichkeit einer Kapsel, Eingaben anzufordern, ist\nein Statuscode im Protokoll, nichts im Dokument. Zudem muss der Text ohne\nLinks im Satz funktionieren. Ein für HTML geschriebener Satz wie „Details\nfinden Sie auf der Preisseite“ behält seine Wörter und verliert seinen\nVerweis. Gute gemtext-Sätze ergeben deshalb auch dann Sinn, wenn der Link\nauf der Zeile darunter steht.\n\nFür die meisten Organisationen lautet die realistische Frage daher, ob sie\ngemtext zusätzlich zur Website anbieten, statt diese zu ersetzen: aus derselben\nQuelle im selben Build erzeugt.\nSo betrachtet kostet es wenig, gemtext zu ergänzen, und es prüft zugleich\nden Text. Lässt sich eine Seite auch als Spalte aus Text- und Linkzeilen klar\nverstehen, dann steckte ihre Struktur schon immer in den Wörtern.\n\n## Wie es in der Praxis aussieht\n\nDiese Website wird neben HTML auch als gemtext veröffentlicht. Die Seite\n[Engineer im Terminal](/de/cli/) nennt die Kapseladresse\n`gemini://engineer.company/`, erklärt, dass jede Seite der Website auch in\ndiesem Format vorliegt, und nennt passende Clients: Amfora, Lagrange und\nBombadillo im Terminal, Castor und Kristall im Fenster. Sie nennt auch den\nGrund. Ein Deployment schreibt einen Ordner, den jeder Zugang liest.\nDie gemtext-Kopie kann deshalb nicht vom HTML abweichen. Eine Seite, die als\ngemtext gut lesbar ist, hat eine echte Struktur statt einer nur aufgemalten.\n\nDie Umsetzung beschreibt\n[der Bericht über die Spiegelung der Website nach Gemini und Gopher](/de/portfolio/mirrored-the-site-to-gemini-and-gopher/).\nGemtext ist ein Ausgabeformat desselben Builds, keine eigene Werkzeugkette.\nDer Websitegenerator erhielt eigene Medientypen und Ausgabeformate.\nJede Seite, jeder Abschnitt und jeder Taxonomiebegriff bekam neben seinem\nHTML und seinem Markdown-Zwilling ein Gemini-Dokument: 777 zum dokumentierten\nUmsetzungsstand, ausgeliefert von einem kleinen Daemon auf demselben Host.\nDie neuen Formate sind als nicht alternative Darstellungen markiert.\nEin separater Build-Vergleich maß beim Hinzufügen dieser Formate null\ngeänderte HTML-Bytes. Spätere redaktionelle oder gestalterische Änderungen\nmaß er nicht.\n\nDie Templates dahinter zeigen, was die Umwandlung in gemtext bedeutet.\nJeder Link im Satz wird herausgehoben: Die Wörter bleiben an der im Satz\nbenötigten Stelle, die Adresse wandert darunter auf eine eigene `=\u003e`-Zeile.\nFettmarkierungen entfallen, Aufzählungsstriche werden zu Sternchen.\nEin Codeblock mit Begrenzungszeilen wird unverändert übernommen, denn eine\nMarkdown-Begrenzungszeile und der Vorformatierungsumschalter von gemtext\nbestehen aus denselben drei Backticks.\n\n## Wo es schiefgeht\n\n### Halbe Zeilen, die nie zusammenfinden\n\nDer Text kommt als zerklüftete Spalte kurzer, mitten im Satzteil gebrochener\nZeilen im Client an. Die Quelle wurde bei 80 Spalten fest umgebrochen,\nwie bei Markdown-Dateien üblich. Die Spezifikation verbietet einem Client,\naufeinanderfolgende kurze Textzeilen zu längeren zusammenzufügen.\nSchreiben Sie jeden Absatz als eine lange Zeile oder lassen Sie den\nKonverter weiche Zeilenumbrüche vor dem Schreiben der Datei zusammenführen.\n\n### Links, die die Kapsel verlassen\n\nDer erste vom Leser gewählte Link öffnet einen Webbrowser. Der Konverter\nschrieb jeden Link als absolute `https://`-Adresse, die ein Gemini-Client an\nein anderes Programm weitergibt. Schreiben Sie die Navigation als vom\nWurzelverzeichnis aus relative Pfade wie `/about/`. Sie werden innerhalb der\nKapsel aufgelöst. Behalten Sie pro Seite einen bewusst gesetzten Link zur\nWebfassung bei.\n\n### Code, der zu einer einzigen Zeile zusammenfällt\n\nEin Codebeispiel erscheint als eine lange Zeile, die direkt an ihrer öffnenden\nBegrenzungszeile hängt. Der Konverter behandelte den Block als normalen Text und fügte seine\nZeilen mit allem anderen zusammen. Teilen Sie das Dokument vor jedem anderen\nSchritt an den Begrenzungszeilen seiner Codeblöcke auf. Geben Sie jeden vorformatierten Block\nunverändert weiter. Die Umschaltzeile darf höchstens einen kurzen Alternativtext\nwie den Namen der Sprache tragen.\n\n### Markdown, das als wörtliche Zeichen erscheint\n\nAufzählungsstriche, doppelte Sternchen, unterstrichene Überschriften,\nverschachtelte Listen und Links in eckigen Klammern erscheinen im Client\ngenau wie eingegeben. Gemtext erkennt für Listeneinträge nur ein Sternchen\nmit Leerzeichen, für Überschriften nur Rautenzeichen. Es hat überhaupt kein\nMarkup innerhalb einer Zeile. Konvertieren Sie diese Konstrukte bei der\nAusgabe oder schreiben Sie die Kapsel direkt im Zielformat.\n\n### Sätze, die auf nichts verweisen\n\nEin Absatz sagt „hier klicken“ oder „wie oben verlinkt“, und der Leser weiß\nnicht, wohin. Der Link wurde aus dem Satz gehoben. Die zurückgebliebenen\nWörter sagten nie, wohin er führte. Schreiben Sie Linkbeschriftungen, die\ndas Ziel benennen. Dann ergeben sowohl der Satz als auch die `=\u003e`-Zeile\nfür sich genommen Sinn.\n\n## Weiterführende Lektüre\n\n- [Kurze Einführung in gemtext-Markup](https://geminiprotocol.net/docs/gemtext.gmi)\n  — die eigene kurze Tour des Projekts durch jede Zeilenart, mit Hinweisen\n  für Menschen mit Markdown-Kenntnissen.\n- [Spezifikation des Gemini-Hypertextformats](https://geminiprotocol.net/docs/gemtext-specification.gmi)\n  — der normative Text: Zeilenarten, Parserzustand, Umbruchregeln, der Parameter\n  `lang` und eine formale Grammatik.\n- [Spezifikation des Gemini-Netzwerkprotokolls](https://geminiprotocol.net/docs/protocol-specification.gmi)\n  — wie eine Kapsel gemtext ausliefert: Anfragen, Statuscodes und die vom\n  Client befolgten TLS-Regeln.\n- [FAQ von Project Gemini](https://geminiprotocol.net/docs/faq.gmi) — die\n  Gründe hinter dem Entwurf, darunter die eigenen Zeilen für Links.\n\n\u003chttps://engineer.company/de/glossary/gemtext/\u003e\n","date_modified":"2026-11-08T09:42:23Z","description":"Wie das Gemini-Dokumentformat gemtext zeilenweise aufgebaut ist, warum Leser die Gestaltung bestimmen und wo Markdown-Gewohnheiten Kapseln stören.","formats":{"gemtext":"https://engineer.company/de/glossary/gemtext/index.gmi","gopher":"https://engineer.company/de/glossary/gemtext/gophermap","html":"https://engineer.company/de/glossary/gemtext/","json":"https://engineer.company/de/glossary/gemtext/index.json","markdown":"https://engineer.company/de/glossary/gemtext/index.md","pdf":"https://engineer.company/de/glossary/gemtext/index.pdf"},"kind":"page","language":"de","title":"Was ist gemtext?","url":"https://engineer.company/de/glossary/gemtext/","version":1}