¿Por qué los programadores usan Markdown?

Mi primera vez usando Markdown

En 2018 empecé a programar. Escribía documentos en Word. Cada vez que subía algo a GitLab, el revisor se quejaba:

"Tu documento Word no se puede comparar. ¿Puedes cambiar a Markdown?"

Pensé que no era importante. Después de varias reuniones dolorosas de "¿qué cambió exactamente?", entendí por qué los programadores usan Markdown.

Ahora llevo seis años usándolo todos los días.

Razón 1: Amigable con Git

Esta es LA razón principal.

Imagínate: tres personas editando el mismo documento.

Con Word:

• Tres versiones: "doc-final", "doc-final-final"
• ¿Fusionar? Compara tres archivos manualmente

Con Markdown + Git:

• Tres ramas, Git muestra conflictos automáticamente
• Historial claro después de resolver

Ejemplo real:

- "max_retries": 3
+ "max_retries": 5

Claro qué cambió.

Razón 2: Texto plano, siempre compatible

Tengo archivos .doc de 2005. Word nuevo los abre con errores.

Markdown es solo texto plano. Cualquier editor lo abre. En 20 años seguirá funcionando.

Además, archivos pequeños. Un documento de 5000 palabras: 8KB en Markdown, 200KB+ en Word.

Razón 3: Resaltado de código nativo

Programadores escriben documentos con mucho código.

```python
def hello():
    print("Hola Mundo")
```

Se renderiza con colores como en el IDE.

¿En Word? Cambiar fuente, agregar fondo gris manualmente... agotador.

Razón 4: Multiplataforma

Escribo en Mac, colega ve en Windows, servidor en Linux—Markdown funciona perfecto.

Word tiene muchos problemas de "funciona en mi máquina".

Razón 5: Herramientas maduras

GitHub / GitLab: README.md, Issues, PRs, Wiki

Editores: VS Code, JetBrains, vim

Documentación: Notion, Obsidian, MkDocs, Docusaurus

Caso real: Cómo usa nuestro equipo

README

# Nombre del Proyecto

## Inicio Rápido

\`\`\`bash
npm install
npm run dev
\`\`\`

Nuevo empleado lee README, ejecuta el proyecto.

Blog Técnico

Usamos Hugo. Escribir, git push, desplegado.

Documentación API

Antes Word: archivos grandes, lento, código manual.

Ahora Markdown + Docusaurus: eficiencia multiplicada.

Limitaciones

No adecuado para:

• Documentos formales para clientes
• Layouts complejos
• Colaborar con no-técnicos

Mi enfoque:

• Contenido técnico: Markdown
• Contratos, propuestas: Word
• Conversión: doc2markdown.com

Consejos para principiantes

Aprende Markdown si estás empezando a programar.

1. Una hora para aprender, beneficios toda la carrera
2. GitHub, GitLab lo necesitan
3. README, Issues, PRs—todo lo usa

Resumen

Razones principales:

1. Git-friendly: Control de versiones claro
2. Texto plano: Siempre compatible
3. Código resaltado: Ventaja para contenido técnico
4. Multiplataforma: Funciona en cualquier dispositivo
5. Herramientas maduras: Integración perfecta