{"canonical_url":"https://engineer.company/es/glossary/gemtext/","content_markdown":"# gemtext\n\n## Qué es\n\nGemtext es el formato documental del protocolo Gemini: texto UTF-8 sencillo donde los primeros caracteres de cada línea deciden su tipo. Así, un cliente puede renderizar toda una página en una pasada de arriba abajo. La especificación lo llama formato de hipertexto Gemini, los servidores lo etiquetan como `text/gemini` y los archivos suelen terminar en `.gmi`.\n\nHay seis tipos de línea. Una que empieza por `=\u003e` es un enlace: dirección absoluta o relativa y una etiqueta opcional después. Una línea de tres acentos graves activa o desactiva el modo preformateado; todo lo que queda entre dos de esas líneas se muestra tal cual en una fuente de ancho fijo. Uno, dos o tres signos de almohadilla forman un encabezado; un asterisco seguido de espacio, un elemento de lista; un signo mayor que, una cita. Las demás líneas son texto ordinario y el cliente las ajusta al ancho de la pantalla que las muestre.\n\n```text\n# Notas de campo\n\nUna línea de texto es un párrafo, sea larga o corta. El cliente la ajusta.\n\n=\u003e /archive/ Notas anteriores\n=\u003e gemini://example.org/ Otra cápsula\n\n* Un elemento de lista\n\u003e Una línea citada\n```\n\nLa especificación divide esos seis tipos en tres básicos que todo cliente debe admitir, texto, enlaces y conmutador de preformato, y tres que un cliente mínimo puede mostrar como texto sencillo. Ese es todo el formato. No hay negrita, cursiva, tablas, imágenes dentro del texto, anidamiento ni forma de hacer pulsable una palabra en mitad de una frase. El analizador conserva un solo bit de estado: si está dentro de un bloque preformateado.\n\nSe suele comparar gemtext con Markdown, al que se parece a primera vista. La diferencia es para qué sirve cada uno. Markdown es código fuente que se convertirá a otra cosa; gemtext ya es el documento terminado y su único renderizador es el cliente del lector. El único hábito estructural que toma de los antiguos menús Gopher es colocar cada enlace en una línea propia.\n\n## Por qué importa\n\nElegir gemtext es elegir quién controla la página. El autor decide la estructura: qué líneas son encabezados, cuáles enlaces y dónde está el código. El cliente decide todo lo demás: fuente, longitud de línea, color, espaciado y si los encabezados forman un índice de contenidos. La especificación dice claramente que no pretende dar al autor un control preciso de la presentación. Para algunos es un alivio; para otros descarta la opción. Conviene saberlo antes de convertir una sola página.\n\nEl alivio está en lo que desaparece. Una página gemtext no lleva hoja de estilo, script, fuente web, aviso de cookies ni píxel de seguimiento; solo hay que actualizar las palabras. Las páginas son pequeñas y rápidas de escribir a mano. Los enlaces no obtienen nada por sí solos: la especificación prohíbe al cliente abrir una conexión de red solo para mostrar uno. La página no puede traer una imagen o fuente de terceros a espaldas del lector.\n\nEl coste es igual de concreto. Solo llega a quienes usan un cliente Gemini, una audiencia pequeña frente a la web. No hay formularios: una cápsula solo pide entrada mediante un código de estado del protocolo, no mediante algo dentro del documento. La prosa debe funcionar sin enlaces dentro de las frases. Una frase HTML como «consulte la página de precios para más detalles» conserva las palabras, pero pierde el enlace. Escribir bien gemtext exige frases que sigan teniendo sentido con el enlace en la línea de debajo.\n\nPor eso, para la mayoría de las organizaciones, la pregunta realista es añadir gemtext al sitio web, no sustituirlo, a partir de la misma fuente y la misma compilación. Así planteado, cuesta poco y también pone a prueba la escritura. Si la página sigue leyéndose claramente como columna de líneas de texto y enlaces, su estructura ya estaba en las palabras.\n\n## Cómo se aplica en la práctica\n\nEste sitio publica gemtext junto a HTML. [Engineer en una terminal](/es/cli/) da la dirección `gemini://engineer.company/`, dice que cada página existe también en ese formato y enumera clientes: Amfora, Lagrange y Bombadillo en terminal; Castor y Kristall en ventana. También explica por qué. Un despliegue escribe una carpeta que leen todas las puertas de entrada: la copia gemtext no puede desincronizarse del HTML. Si una página se lee bien como gemtext, su estructura es real y no una apariencia pintada.\n\nLa [explicación de cómo se replicó el sitio en Gemini y Gopher](/es/portfolio/mirrored-the-site-to-gemini-and-gopher/) describe la construcción. Gemtext es otro formato de salida de la misma compilación, no otra cadena de herramientas. Se añadieron tipos de medios y formatos de salida propios al generador; cada página, sección y término de taxonomía recibió un documento Gemini junto a su HTML y su gemelo Markdown. Eran 777 en la etapa de implementación documentada, servidos por un pequeño demonio en el mismo host. Los formatos nuevos se marcan como representaciones no alternativas. Una comparación de compilaciones separada midió cero bytes HTML cambiados al añadirlos; no midió posteriores cambios editoriales o visuales.\n\nLas plantillas muestran qué implica la conversión. Se saca cada enlace de su frase: las palabras quedan donde hacen falta y la dirección baja a una línea `=\u003e` propia. Se eliminan las marcas de negrita, los guiones de lista pasan a asteriscos y un bloque de código delimitado se conserva intacto: la delimitación Markdown y el conmutador de preformato gemtext son los mismos tres acentos graves.\n\n## Dónde surgen los problemas\n\n### Líneas partidas que nunca se unen\n\nLa prosa llega como columna irregular de líneas cortas, partidas a mitad de una oración. El original se dividió a 80 columnas, como suele hacerse en Markdown, y la especificación prohíbe al cliente unir líneas cortas consecutivas en otras largas. Escriba cada párrafo en una sola línea o haga que el conversor una los saltos de línea introducidos solo para ajustar el texto antes de escribir el archivo.\n\n### Enlaces que salen de la cápsula\n\nEl primer enlace abre un navegador web. El conversor escribió todos como direcciones `https://` absolutas y el cliente Gemini las entrega a otro programa. Escriba la navegación con rutas relativas a la raíz como `/about/`, que se resuelven dentro de la cápsula, y mantenga un enlace deliberado por página a su versión web.\n\n### Código que se convierte en una sola línea\n\nUn ejemplo de código aparece como línea larga pegada al delimitador inicial. El conversor trató el bloque como prosa y unió sus líneas con las demás. Divida el documento por sus delimitadores antes de cualquier otro paso, conserve cada bloque preformateado tal cual y limite el texto alternativo de la línea de conmutación a algo breve, como el nombre del lenguaje.\n\n### Markdown que aparece como caracteres literales\n\nGuiones de lista, asteriscos dobles, encabezados subrayados, listas anidadas y enlaces entre corchetes aparecen tal cual. Gemtext solo reconoce asterisco y espacio para una lista y almohadillas para un encabezado; no tiene marcado dentro de las frases. Convierta esas construcciones al generar la salida o escriba directamente en gemtext.\n\n### Frases que no señalan ningún destino\n\nUn párrafo dice «pulse aquí» o «como se enlaza arriba» y el lector no sabe adónde ir. El enlace salió de la frase y las palabras restantes nunca decían adónde llevaba. Escriba etiquetas que nombren su destino: así, tanto la frase como la línea `=\u003e` tienen sentido por separado.\n\n## Lecturas adicionales\n\n- [Introducción breve al marcado gemtext](https://geminiprotocol.net/docs/gemtext.gmi)\n  — Recorrido del proyecto por todos los tipos de línea, con notas para quienes conocen Markdown.\n- [Especificación del formato de hipertexto Gemini](https://geminiprotocol.net/docs/gemtext-specification.gmi)\n  — Texto normativo: tipos de línea, estado del analizador, reglas de ajuste, parámetro `lang` y gramática formal.\n- [Especificación del protocolo de red Gemini](https://geminiprotocol.net/docs/protocol-specification.gmi)\n  — Cómo sirve gemtext una cápsula: solicitudes, códigos de estado y reglas TLS del cliente.\n- [Preguntas frecuentes del proyecto Gemini](https://geminiprotocol.net/docs/faq.gmi)\n  — Razones del diseño, entre ellas por qué los enlaces ocupan líneas propias.\n\n\u003chttps://engineer.company/es/glossary/gemtext/\u003e\n","date_modified":"2026-11-09T21:50:25Z","description":"Cómo se escribe gemtext línea a línea, por qué el formato documental de Gemini deja la presentación al lector y qué hábitos de Markdown rompen una cápsula.","formats":{"gemtext":"https://engineer.company/es/glossary/gemtext/index.gmi","gopher":"https://engineer.company/es/glossary/gemtext/gophermap","html":"https://engineer.company/es/glossary/gemtext/","json":"https://engineer.company/es/glossary/gemtext/index.json","markdown":"https://engineer.company/es/glossary/gemtext/index.md","pdf":"https://engineer.company/es/glossary/gemtext/index.pdf"},"kind":"page","language":"es","title":"¿Qué es gemtext?","url":"https://engineer.company/es/glossary/gemtext/","version":1}