STXT frente a Markdown

Esta es la única comparación de la serie que no es una elección. Markdown responde a "¿cómo escribo negritas, enlaces y listas dentro de un texto?"; STXT responde a "¿cuáles son las partes de este documento, y están todas?". Un README necesita la primera pregunta; un contrato, un pipeline de artículos o un corpus de registros estructurados necesita las dos.

Dónde termina Markdown

Markdown no tiene noción de campos. En cuanto un documento necesita datos — un autor, una fecha, un estado —, el ecosistema recurre al front matter: un bloque YAML entre vallas ---, invisible para el propio Markdown y parseado por un segundo lenguaje con sus propias reglas:

---
title: Style guide
author: Ana López
published: 2026-09-01
---

# Style guide

Write **short** sentences. Prefer [links](https://example.com) to footnotes.

La estructura de ese fichero existe solo por convención: nada comprueba que published sea una fecha, que author esté presente, o que el cuerpo siga las secciones acordadas. No es un defecto de Markdown — nunca prometió otra cosa —, pero marca la frontera donde el formato se acaba y la estructura tiene que empezar.

El mismo documento en STXT

En STXT la ficha son nodos, y la prosa es un bloque de texto cuyo tipo lo declara como Markdown:

Template (@stxt.template): com.example.article
	Structure >>
		Article (com.example.article):
			Author: (+)
			Published: (1) DATE
			Body: (1) MARKDOWN

Article (com.example.article): Style guide
	Author: Ana López
	Published: 2026-09-01
	Body >>
		Write **short** sentences. Prefer [links](https://example.com) to footnotes.

MARKDOWN es el único formato embebido que define la capa de esquemas, precisamente porque los dos lenguajes se reparten el trabajo: un nodo declarado con ese tipo marca su texto como prosa con formato, a interpretar como CommonMark, y la forma cruda sigue siendo legible (STXT-SCHEMA-SPEC §9.7). El validador garantiza ahora lo que el front matter solo podía sugerir: el autor está, la fecha es una fecha, el cuerpo es exactamente un bloque.

Una estructura que Markdown no puede comprobar

El reparto escala más allá de un artículo. Este portal es el ejemplo en funcionamiento: cada página de stxt.dev — esta incluida — es un documento STXT cuyos bloques de prosa son Markdown, validado contra la plantilla del sitio antes de que un generador lo renderice, como describe el caso de uso de CMS y publicaciones. Añade .stxt a la dirección de cualquier página para leer la fuente.

Cuándo usar cada uno

Para un README, un comentario, un gist — prosa con formato ligero y sin contrato —, Markdown solo es la herramienta correcta, y STXT no añadiría nada.

Recurre a STXT cuando el documento tiene partes que merecen nombre y comprobación: artículos en un pipeline, registros corporativos, propuestas técnicas. La prosa de dentro sigue siendo Markdown; la estructura de alrededor se vuelve explícita y validada. El tutorial recorre el lenguaje en quince secciones breves, el playground ejecuta el ejemplo de arriba, y la versión corta de esta página está en la FAQ.