Blog
life2026-07-105 min

Editor Markdown

Conozca la sintaxis de Markdown creada por John Gruber en 2004, incluyendo encabezados, tablas, listas y formato de texto para documentación.


Editor Markdown

Markdown es un lenguaje de marcado ligero. Creado por John Gruber y Aaron Swartz en 2004. Su objetivo: permitir la escritura de textos formateados utilizando una sintaxis simple, legible y que pueda convertirse fácilmente a HTML. Nada de etiquetas complicadas. Nada de menús escondidos. Solo texto plano que cobra vida. Se ha convertido en el estándar de facto para documentación técnica, mensajes en foros, README de proyectos y escritura en la web. Como dice el dicho: «Lo simple es lo más difícil de lograr». Y Markdown lo logró.


monitor showing Java programming

Photo by Ilya Pavlov on Unsplash

Historia de Markdown

John Gruber, blogger y diseñador, creó Markdown en colaboración con Aaron Swartz, un prodigio de la programación. La motivación era crear un formato que fuera tan legible como el texto plano pero que pudiera convertirse a HTML válido. Gruber publicó el primer intérprete de Markdown en Perl en marzo de 2004.

La filosofía de Markdown se resume en las palabras de Gruber: "La principal inspiración para Markdown es el formato de texto plano utilizado en el correo electrónico". El objetivo era que un documento en Markdown fuera publicable tal cual, sin necesidad de etiquetas de formato visibles.

Sintaxis Básica

Encabezados

Los encabezados se crean con el símbolo #. El número de símbolos indica el nivel:

  • `# Nivel 1` (equivalente a h1)

  • `## Nivel 2` (h2)

  • `### Nivel 3` (h3)

  • `#### Nivel 4` (h4)

  • `##### Nivel 5` (h5)

  • `###### Nivel 6` (h6)


Formato de Texto

  • Negrita: `texto` o `__texto__`

  • Cursiva: `texto` o `_texto_`

  • ~~Tachado~~: `~~texto~~`

  • `Código en línea`: se usa el acento grave `` ` ``


Listas

Las listas no ordenadas utilizan guiones, asteriscos o signos más:

```

  • Elemento 1

  • Elemento 2

- Subelemento 2.1
```

Las listas ordenadas utilizan números:

```

  • Primer elemento

  • Segundo elemento

  • ```

    Enlaces e Imágenes

    Los enlaces se crean con `texto`. Las imágenes con `!alt`.

    Tablas

    Las tablas no formaban parte de la especificación original de Markdown, pero fueron añadidas por extensiones como GitHub Flavored Markdown (GFM). Se crean utilizando tuberías (|) y guiones (-):

    ```
    | Encabezado 1 | Encabezado 2 |
    |--------------|--------------|
    | Celda 1 | Celda 2 |
    | Celda 3 | Celda 4 |
    ```

    La alineación se controla con dos puntos en la línea de separación:

    • `:---` alineación izquierda

    • `:---:` alineación centrada

    • `---:` alineación derecha


    Bloques de Código

    Los bloques de código se crean con triple acento grave (```) o sangría de 4 espacios:

    ```
    ```
    function saludar(nombre) {
    return `Hola, ${nombre}!`;
    }
    ```
    ```

    Se puede especificar el lenguaje para resaltado de sintaxis.

    Extensiones Populares

    Existen múltiples extensiones de Markdown. GitHub Flavored Markdown (GFM) añade tablas, listas de tareas, tachado y enlaces automáticos. La sintaxis de Markdown Extendido (Pandoc) añade notas al pie, tablas multilínea y matemáticas en LaTeX como `$E=mc^2$`.

    Mi amiga Valeria, diseñadora UX, se negaba a usar Markdown. «Prefiero el Word de toda la vida», decía. Hasta que un día, en medio de un proyecto, tuvo que escribir documentación técnica para un equipo de doce desarrolladores. Le expliqué que con Markdown podía escribir un README, formatearlo y compartirlo sin que nadie tuviera que abrir un archivo .docx. «Espera —dijo—, ¿puedo hacer tablas?». «Sí». «¿Y código?». «Sí». «¿Y lo ve todo el mundo igual?». «Sí, Valeria, por eso lo usa todo el mundo». Ahora escribe hasta la lista de la compra en Markdown. Hasta le ha puesto nombre a su archivo: `lista-compra.md`.

    Aplicación Práctica

    El editor Markdown le permite escribir y previsualizar documentos en Markdown en tiempo real. Puede utilizar todas las funcionalidades de sintaxis descritas para crear documentación técnica, artículos de blog, notas de clase o cualquier otro tipo de contenido textual.

    Markdown ha revolucionado la forma en que los desarrolladores y escritores crean contenido para la web, combinando la simplicidad del texto plano con la potencia del formato HTML.