Markdown para escribir mejores prompts

Si usas Claude, ChatGPT u otro modelo de lenguaje en tu trabajo, aprender Markdown es la mejora más barata que puedes hacer a tus prompts. Markdown es una forma de escribir texto plano con marcas simples (un # para un título, un guion para una lista) y es el formato en que estos modelos suelen responder y en que mejor se ordenan las instrucciones. Un prompt dividido en rol, contexto, documentos, tarea, formato de salida y restricciones deja menos espacio a la interpretación que un párrafo largo. Se aprende en una tarde, y en esta guía va todo lo necesario.

Por qué un abogado debería escribir en Markdown

Los abogados estamos acostumbrados a escribir en procesadores de texto, donde el formato se aplica con botones. Esa costumbre no sirve con un modelo de lenguaje, porque al pegar un texto en el chat se pierden las negritas y los estilos de Word, y lo que queda es un bloque de texto sin jerarquía. Markdown, en cambio, lleva la estructura dentro del propio texto, y el modelo la ve.

Hay razones concretas para adoptarlo.

• Los modelos responden en Markdown: Cuando Claude devuelve títulos, listas y tablas, lo hace con estas mismas marcas. Si las conoces, puedes pedir el formato exacto que necesitas y reutilizar la respuesta sin limpiarla.
• Los propios desarrolladores lo recomiendan: La guía de prompts de OpenAI para GPT-4.1 aconseja partir usando títulos de Markdown para las secciones y subsecciones del prompt. La guía de buenas prácticas de Anthropic insiste en separar instrucciones, contexto, ejemplos y documentos, y propone para eso etiquetas tipo XML, que conviven bien con Markdown.
• Obliga a pensar el encargo: Escribir un título "Tarea" y otro "Restricciones" te hace notar lo que faltaba. Muchos malos resultados vienen de instrucciones incompletas, no de un mal modelo.
• Es reutilizable: Un prompt en Markdown es un archivo de texto que puedes guardar, versionar y convertir en plantilla.

La sintaxis esencial en diez minutos

Markdown tiene variantes, pero lo básico es común a casi todas. Si quieres practicar, el sitio de CommonMark tiene una referencia breve y un tutorial interactivo de diez minutos.

Títulos

Se marcan con almohadillas al inicio de la línea. Una para el título principal, dos para una sección, tres para una subsección.

# Análisis de despido
## Hechos
### Comunicación del despido

Negritas y cursivas

Dos asteriscos para negrita y uno para cursiva. En un prompt, la negrita sirve para destacar una instrucción que no se puede pasar por alto.

**No inventes jurisprudencia.**
Cita la norma *solo* si aparece en los documentos entregados.

Listas y listas numeradas

Un guion y un espacio crean una viñeta; un número con punto crea una lista ordenada. Las listas numeradas son ideales para pasos que deben seguirse en orden.

- Contrato de trabajo
- Carta de despido
- Últimas tres liquidaciones

1. Lee la carta de despido.
2. Identifica la causal invocada.
3. Compara los hechos de la carta con los documentos.

Citas

El signo mayor que, al inicio de la línea, marca un texto citado. Lo uso para pegar el párrafo exacto de un documento sobre el que quiero una opinión.

> La empresa ha decidido poner término a su contrato de trabajo
> por necesidades de la empresa.

Bloques de código

Tres comillas invertidas abren y cierran un bloque. Sirven para encerrar un texto largo que el modelo debe tratar como material y no como instrucción, o para pedir que la respuesta venga en un formato exacto.

```
(pegar aquí la transcripción de la carta de despido)
```

Tablas

Las columnas se separan con barras verticales y la segunda línea, con guiones, separa el encabezado. Las tablas no son parte del Markdown original, sino de la extensión de GitHub Flavored Markdown, que hoy entienden la mayoría de los editores y los modelos.

| Documento        | Fecha      | Observación         |
|------------------|------------|---------------------|
| Carta de despido | 2024-03-15 | Causal genérica     |
| Finiquito        | 2024-03-20 | Monto distinto      |

Separadores

Tres guiones en una línea sola dibujan una línea horizontal. En un prompt largo, ayudan a separar las instrucciones del material que viene después.

---

Un prompt mal hecho y el mismo prompt bien estructurado

El mismo encargo, escrito de dos maneras. A la izquierda, como suele escribirse en el apuro; a la derecha, ordenado en Markdown. Los dos piden lo mismo, el análisis preliminar de un despido por necesidades de la empresa.

hola necesito que me ayudes con un caso de un trabajador que lo despidieron por necesidades de la empresa y quiero saber si el despido está bien hecho o no, te paso la carta y el contrato y las liquidaciones, fíjate en todo lo importante como los plazos y lo que le deben pagar y si la carta cumple, ojalá con jurisprudencia, y que sea breve pero completo para mandárselo al cliente

# Rol
Actúa como asistente de un abogado laboralista chileno
que representa a trabajadores.

## Contexto
Despido por necesidades de la empresa
(art. 161 del Código del Trabajo).
Análisis preliminar, antes de la primera reunión.

## Documentos
- Carta de despido
- Contrato de trabajo
- Liquidaciones de los últimos tres meses

## Tarea
1. Verifica si la carta cumple los requisitos
   del art. 162 del Código del Trabajo.
2. Indica si los hechos de la carta son concretos
   o genéricos.
3. Lista las prestaciones que podrían reclamarse.

## Formato de salida
- Tabla con requisito, cumple o no cumple, y fundamento.
- Máximo una página.

## Restricciones
- Usa solo los documentos entregados.
- No cites fallos; si los necesitas, indícalo.
- Marca con [verificar] todo dato dudoso.

Qué cambió entre una versión y otra

• El rol fija el punto de vista: No es lo mismo analizar un despido desde la defensa del trabajador que desde la empresa.
• El contexto dice para qué es el análisis: Un análisis preliminar interno exige otro nivel de detalle que un texto para el cliente.
• Los documentos quedan identificados: El modelo sabe qué material tiene y puede advertir si falta algo.
• La tarea se divide en pasos numerados: "Fíjate en todo lo importante" es una instrucción imposible de cumplir bien; tres preguntas concretas no lo son.
• El formato de salida evita reescribir: Pedir una tabla y una extensión máxima ahorra una segunda vuelta.
• Las restricciones cierran la puerta a lo peor: Pedir jurisprudencia sin entregarla invita a que el modelo invente citas, un riesgo que ya ha terminado en sanciones para abogados que no verificaron las citas.

Un detalle más. La versión estructurada no pide un texto "para mandárselo al cliente". La comunicación con el cliente es trabajo del abogado, y conviene escribirla después de revisar el análisis.

Escribe el prompt aparte, en un editor de Markdown

El cuadro de texto del chat es un mal lugar para redactar un prompt largo, porque es pequeño, no muestra la estructura y lo que escribes se pierde con la conversación. Yo redacto los prompts importantes en ghostwriter, un editor de Markdown libre y gratuito desarrollado por la comunidad KDE, disponible para Linux, Windows y macOS.

Tiene lo justo para este trabajo.

• Vista previa en vivo: Mientras escribes a un lado, ves el resultado con títulos y listas al otro.
• Esquema lateral: Muestra los títulos del documento y permite saltar entre las secciones de un prompt largo.
• Modo de concentración: Atenúa todo menos la línea o el párrafo que estás escribiendo.
• Contador de palabras: Útil para no pasarse de largo en el contexto.

En Debian está en los repositorios oficiales, así que basta con instalar el paquete ghostwriter con apt; en otras distribuciones también está en Flathub y en la tienda Snap. Cualquier editor de Markdown sirve para lo mismo, y Obsidian también puede cumplir esa función.

Guarda tus prompts como plantillas

El paso que más tiempo ahorra es dejar de escribir los prompts desde cero. Cuando un prompt funciona, lo guardo como archivo .md en una carpeta de plantillas, con un nombre que diga para qué sirve.

• Un archivo por tarea: Por ejemplo, analisis-preliminar-despido.md, resumen-de-sentencia.md o yaml-para-documento-del-expediente.md.
• Campos para rellenar bien marcados: Escribe entre paréntesis lo que cambia en cada uso, como (pegar aquí la carta de despido), para no enviar nunca una plantilla incompleta.
• Una sección de notas al final: Anota qué ajustes funcionaron y cuáles no, para mejorar la plantilla con el tiempo.
• Sin datos de clientes: La plantilla es genérica; los datos del caso entran solo en la copia que usas.

Si quieres ver una plantilla completa aplicada a un flujo real, el prompt para generar metadatos de documentos está en la guía para convertir un expediente en PDF en un mapa del caso con LlamaParse, Obsidian y Claude.

Errores frecuentes al estructurar prompts

• Estructura sin contenido: Los títulos no ayudan si debajo de "Contexto" no hay contexto. La estructura es una lista de chequeo, no un adorno.
• Instrucciones contradictorias: "Sé breve" en una sección y "desarrolla cada punto en detalle" en otra. Relee el prompt completo antes de enviarlo.
• Mezclar instrucciones con documentos: Si pegas una carta en medio de las instrucciones, el modelo puede confundir lo que dice la carta con lo que le pides. Deja los documentos en su propia sección o dentro de un bloque.
• Olvidar el formato de salida: Si no lo pides, el modelo elige por ti.

En resumen

Markdown no es un tema técnico reservado a programadores; es una forma ordenada de escribir que los modelos de lenguaje entienden bien. Aprende títulos, listas, citas, bloques y tablas, redacta tus prompts aparte en un editor como ghostwriter, y guarda los que funcionan como plantillas. Tus resultados mejorarán por la misma razón por la que mejora un escrito bien estructurado, porque quien lo lee entiende qué se le pide. Y si tienes una plantilla que te funciona, puedes compartirla con otros colegas en ia-derecho.cl.