Prompts estructurados: Markdown, XML, JSON y delimitadores

Qué aprenderás

• Usar marcas visibles para reducir ambigüedad.
• Distinguir para qué sirven Markdown, XML y JSON.
• Elegir estructura por necesidad, sin coronar un formato universal.

Estructurar para hacer legible la tarea

Cuando un pedido tiene varias piezas, encabezados, etiquetas o delimitadores ayudan a indicar qué pertenece a cada sección. La estructura organiza el mensaje para personas y modelos; no vuelve verdaderas las afirmaciones ni impone por sí sola un esquema.

Markdown

Encabezados, listas y bloques de código funcionan bien para instrucciones legibles y documentación:

# Objetivo
Comparar las opciones para el equipo de compras.

# Datos
Usá las propuestas adjuntas.

# Salida
Una lista de ventajas, diferencias y datos faltantes.

XML

Las etiquetas nombradas separan regiones y hacen explícito su propósito:

<instructions>
Resumí el reclamo en dos oraciones. No inventes hechos.
</instructions>

El paquete figura entregado, pero no lo recibí.

Son útiles cuando necesitás límites y nombres definidos, sobre todo al combinar varios bloques. El texto dentro de etiquetas sigue siendo texto: XML no agrega seguridad ni valida la respuesta por sí solo.

JSON

JSON sirve para representar datos estructurados y es práctico cuando la entrada ya está en ese formato o una aplicación espera leer campos:

{
  "categoria": "envio",
  "prioridad": "alta",
  "evidencia": "figura entregado, pero no lo recibió"
}

Pedir al modelo que responda con JSON no equivale a validarlo. Verificá sintaxis, tipos, campos obligatorios y valores permitidos. Si una API ofrece salida estructurada nativa, consultá su documentación y validá el contrato de integración.

No existe un ranking Markdown > XML > JSON

Markdown suele ser cómodo para humanos; XML puede etiquetar regiones; JSON es apropiado para datos procesables. Ninguno mejora siempre el resultado. Elegí según tarea, consumidores, herramientas disponibles y facilidad de validación. También se pueden combinar formatos cuando cada uno cumple un propósito concreto.

Los delimitadores ( ` , --- INICIO ---, <datos>) permiten reconocer dónde comienza y termina un bloque. No mezcles un fragmento sin marcarlo con las instrucciones que lo describen.

Ejercicio

Tomá una lista de incidentes en JSON. Escribí instrucciones Markdown que expliquen la clasificación y delimitá la lista de datos; pedí un objeto de salida con campos nombrados. Anotá qué validaría tu aplicación antes de aceptarlo.

Autoevaluación

¿Qué formato usarías para un informe que leerá una persona y para un proceso que lo importará? Para lectura, Markdown/listas pueden ser más claros; para importación, JSON con contrato validado puede resultar apropiado. La decisión depende del consumidor, no de un ranking universal.

Fuentes

• OpenAI, Message formatting with Markdown and XML — uso de estructura y separación; consulta: 2026-10-03.
• W3C, XML 1.0 — especificación del formato XML; consulta: 2026-10-03.
• IETF, RFC 8259: JSON — sintaxis e interoperabilidad; consulta: 2026-10-03.
• CommonMark, CommonMark help — referencia de Markdown; consulta: 2026-10-03.

Seguir aprendiendo

• Unidad 6: separar explícitamente datos e instrucciones.
• Unidad 7: especificar una salida que pueda leerse o validarse.