Markdown: El lenguaje universal para hablar con la IA

Este capítulo cambia a un tema más ligero: algo que probablemente usas a diario pero quizás no conoces por su nombre: Markdown.

Permíteme comenzar con una afirmación audaz:

Markdown es el formato más importante que deberías aprender en la era de la IA.

¿Por qué? Sigue leyendo.

¿Qué es Markdown?

En una frase: Markdown es una forma de escribir texto plano con formato controlado mediante símbolos.

El texto plano no tiene formato —ni encabezados, ni negritas, ni listas. Por otro lado, los formatos de texto enriquecido como Word son demasiado pesados: requieren software especial para abrirlos y generan archivos grandes.

Markdown es el punto medio “justo”: con unos pocos símbolos simples, puedes añadir formato al texto plano.

Por ejemplo, si escribes:

# This is a heading
**This is bold**
- This is a list

Se muestra como un encabezado con formato, texto en negrita y una lista. Así de simple.

Por qué debes aprender Markdown en la era de la IA

Razón 1: La IA habla Markdown

¿Has notado que cuando ChatGPT, Claude, Gemini y otras IAs te responden, incluyen automáticamente texto en negrita, encabezados, listas y bloques de código?

Eso es Markdown.

La IA no genera documentos de Word ni PDFs. Su formato de salida predeterminado es Markdown. Cada tabla, texto en negrita y bloque de código que ves en este tutorial —todo Markdown.

No aprender Markdown es como hablar con alguien pero no entender las palabras que escribe. ¿Puedes comunicarte? Sí. Pero es mucho menos eficiente.

Razón 2: Está en todas partes

Markdown no es un formato propietario de un software específico; es un estándar universal. La cantidad de herramientas que soportan Markdown es innumerable:

Aprende un formato, úsalo en todas partes. Las notas que escribes en Obsidian mantienen su formato al copiarlas a GitHub. Lánzalas a una IA y las entiende perfectamente. ¿Intenta eso con Word?

Razón 3: Archivos increíblemente pequeños

Esto puede sorprenderte: Para el mismo contenido, un archivo Markdown es más de 20 veces más pequeño que un archivo de Word.

¿Por qué? Un archivo .docx de Word es esencialmente un archivo comprimido de archivos XML, repleto de definiciones de estilo, información de fuentes y propiedades del documento. Incluso si escribes solo una línea, el archivo pesa decenas de KB.

Markdown es texto plano. El tamaño del archivo equivale a la cantidad de texto que escribes. Sin equipaje extra.

Esto es especialmente importante en escenarios de IA. Cuando envías un documento a una IA para su análisis, Markdown consume menos tokens, procesa más rápido y cuesta menos. Todas esas etiquetas XML y definiciones de estilo en un archivo de Word se cuentan como tokens, desperdiciados.

Razón 4: La IA entiende mejor Markdown

Mucha gente no sabe esto.

Si le das a una IA un documento de Word, primero tiene que convertirlo a texto. Durante la conversión, el formato puede perderse, las tablas pueden desalinearse y las imágenes desaparecen.

Dale a una IA un archivo Markdown, y lo lee directamente. Markdown es texto plano en sí mismo —no necesita conversión, cero pérdidas.

Aún más importante, los símbolos de Markdown (encabezados con #, listas con -, código con `) son instrucciones semánticas. La IA entiende que # significa “esto es un título”, no solo “texto grande”. Esto le permite comprender mejor la estructura y jerarquía de tu documento.

Aprende Markdown en 10 minutos

No necesitas memorizar todo. Aquí tienes lo esencial:

1. Encabezados

``` ``) inherently tell the AI, “this is a heading, this is a list, this is code.” The AI can understand your content structure more accurately.

Learn Markdown in 10 Minutes

There are only about a dozen Markdown syntax elements, and even fewer are needed for daily use. Below, they are ordered by frequency of use, starting with the most common.

1. Headings

Use # followed by a space. The number of # symbols indicates the heading level:

### 2. Énfasis (negrita y cursiva)

For daily use, up to level 3 is enough.

2. Bold and Italic

### 3. Listas

**Listas desordenadas:**

Bold is used most often, italic occasionally.

3. Lists

Unordered lists use - or *:

**Listas ordenadas:**

Ordered lists use numbers followed by a period:

**Listas anidadas:**

Lists can be nested by adding two spaces before the sub-item:

### 4. Código

**Código en línea:**

4. Code

Inline code uses single backticks:

**Bloques de código:**

Result: Type claude --help to see help

Code blocks are wrapped with three backticks, and you can specify the language:

```python
print("Hello World")

This is especially useful when communicating with AI. When sending code to an AI, wrap it in a code block so the AI can more accurately identify the code boundaries.

### 5. Links and Images

```

### 5. Enlaces e imágenes

```

Images are just links with a `!` in front.

### 6. Blockquotes

Start with `>`:

```

### 6. Citas en bloque

```

Result:

> This is a blockquote.
> It can span multiple lines.

### 7. Tables

```

### 7. Tablas

```

Table syntax looks complex, but you don’t need to write it by hand. **Just ask the AI to generate it for you.** Say “organize this data into a table,” and the AI will output a Markdown table.

### 8. Horizontal Rules

Three or more `-` on a single line:

```

### 8. Línea horizontal

```

Used to separate different sections of an article.

### 9. Strikethrough

```

### 9. Tachado

```

Result: ~~Deleted text~~

---

## That’s Enough, Really

The 9 syntax elements above cover 99% of daily use cases.

**You don’t need to master Markdown.** Headings, bold, lists, and code blocks—master these four and you can handle most situations. Look up the rest when needed.

And Markdown has one advantage: **It’s okay if you can’t remember it all now; you’ll learn it by using it.** AI outputs Markdown, so as you read AI responses every day, you’ll naturally become familiar with these symbols.

---

## How to Use Markdown to Improve Communication with AI

After learning Markdown, here are a few tips to make your conversations with AI more effective:

**Tip 1: Use headings to structure your input**

```

---

## Cómo usar Markdown para comunicarte con la IA

### 1. Usa encabezados para estructurar

No escribas un párrafo enorme. Divide tu mensaje en secciones:

```

Much better than a big block of text. With headings, the AI can more accurately understand the structure of your request.

**Tip 2: Wrap code in code blocks**

Don’t just paste code directly; wrap it in a code block:

```

### 2. Envuelve el código en bloques de código

Cuando pidas a la IA que analice código, siempre ponlo en un bloque de código:

```python
def hello()
    print("hello")
```

### 3. Usa listas para requisitos

The AI can precisely distinguish between your words and the code.

Tip 3: Use lists to enumerate requirements

### 4. Sintaxis completa (9 cubren el 99%): Además enlaces, imágenes, citas en bloque, tablas, líneas horizontales

### 5. Consejos para comunicarte con la IA: Usa encabezados para estructurar, envuelve el código en bloques de código, usa listas para requisitos

**Conclusiones clave:**

- **Markdown es el "idioma nativo" de la IA; aprenderlo significa aprender a comunicarse eficientemente con la IA**
- **Aprende lo básico en 10 minutos, consulta el resto cuando lo necesites**
- **No necesitas práctica deliberada; lo aprenderás naturalmente mientras usas la IA**

---

## Parte 2: API y Tokens: El núcleo técnico