¿Qué es Markdown y cómo se lee un archivo .md?

Alguien le envió un archivo cuyo nombre termina en .md, o tiene delante un texto salpicado de asteriscos, almohadillas y corchetes: **así**, # asá. A primera vista parece roto. No está roto, está con formato, y esa manera de escribir se llama Markdown.

La idea es sencilla. En lugar de buscar botones para dar formato al texto, usted escribe el formato dentro del propio texto con un puñado de marcas. Una palabra rodeada de asteriscos queda en negrita; un renglón que empieza con almohadilla se convierte en título. Un programa que entiende esas marcas produce un documento ordenado, y uno que no las entiende muestra igualmente un texto legible, porque dentro no hay nada escondido.

Cómo se abre un archivo .md

Un archivo Markdown no es más que escritura corriente, así que cualquier editor de texto lo abrirá. Arranque el editor, elija Abrir en el menú Archivo y ponga la lista de tipos de archivo, en la esquina del cuadro de diálogo, en «Todos los archivos»: mientras esa lista diga «Documentos de texto», su archivo .md sencillamente no aparecerá. Lo que obtiene es el archivo entero, marcas incluidas.

Para verlo maquetado en vez de en crudo tiene dos caminos. Puede abrirlo en una aplicación que entienda Markdown: muchas aplicaciones de notas, editores de código y plataformas de repositorios lo muestran con formato en cuanto se carga. O puede convertir el texto a HTML y abrir ese resultado en un navegador, que es la vía más cómoda cuando hay que enviar el documento o colocarlo en una página web.

Si no ve la extensión —el nombre del archivo no termina en .md en pantalla—, marque «Extensiones de nombre de archivo» en la pestaña Vista del Explorador de archivos, en Windows. Ver la extensión es la manera más rápida de saber a qué programa pertenece un archivo.

Un apunte para quien escribe en español: como el archivo es texto pelado, todo lo que salga del alfabeto inglés —vocales acentuadas, eñes, diéresis, signos de admiración e interrogación invertidos— solo sobrevive si el editor guarda en UTF-8. Casi todos los editores actuales lo hacen solos, pero si sus acentos vuelven desordenados después de una ida y vuelta, ese es el ajuste que conviene revisar al guardar.

Las marcas que de verdad se encuentran

No hace falta aprenderse Markdown entero; la escritura del día a día cabe casi por completo en las marcas de abajo. Leer la tabla una vez basta para descifrar cualquier texto que le caiga en las manos.

Vigile un detalle: la mayoría de estas marcas van justo al principio del renglón y llevan un espacio detrás. Si olvida el espacio entre la almohadilla y el texto del título, el renglón se queda exactamente como lo escribió.

Dónde se cruza uno con Markdown

Como Markdown lleva su formato dentro del texto, ese formato no puede perderse por el camino. Por eso se prefiere en todos los sitios donde lo escrito pasa de mano en mano.

Donde más aparece es en los repositorios de código: el archivo README que presenta un proyecto es Markdown casi sin excepción. Más allá de eso, las aplicaciones de notas, los wikis de equipo, los foros, las aplicaciones de mensajería y los generadores de blogs usan la misma notación. Los asteriscos que ve en un texto copiado de una conversación con una inteligencia artificial son exactamente lo mismo.

Frente a un procesador de textos, la diferencia es esta. En un documento de Word el formato vive en un lugar que usted no ve, y el programa que abre el archivo tiene que entenderlo. En Markdown el formato está delante de sus ojos. El precio es que las maquetaciones elaboradas —varias columnas, notas al pie, números de página— sencillamente no existen en Markdown: se diseñó para documentos cortos y planos.

Convertir el texto a HTML

Si el texto va destinado a una página web, a un gestor de contenidos o al cuerpo de un correo, en medio se cuela un paso de traducción: el HTML. Pegue el texto en la herramienta Markdown a HTML y los títulos, las listas y los enlaces se convierten en las etiquetas correspondientes.

Hay dos salidas y la elección depende del destino. Si la página ya existe —una entrada en un gestor de contenidos, una plantilla de correo—, tome la primera: se detiene en el contenido y deja en paz la envoltura. Si lo que quiere es un archivo que se abra solo con doble clic, tome la segunda, que añade esa envoltura alrededor.

La cobertura llega hasta el vocabulario corriente: títulos, negrita, cursiva, listas, citas, enlaces y código. Una tabla, una imagen o una lista de varios niveles no se transforma; su marca sigue a la vista en el resultado en vez de evaporarse, y así puede localizarla y terminar usted mismo esos pasajes.

Las tablas: el estándar y sus dialectos

La definición original de Markdown no incluye tablas. Las tablas llegaron después, mediante extensiones que añadió cada plataforma; por eso la misma tabla se ve bien en un sitio y sale en otro como renglón tras renglón de texto pelado. Mire dónde piensa publicar antes de escribir una.

La notación construye las columnas con barras verticales y exige un renglón de separación justo debajo de la fila de encabezados. Las barras son lo único que cuenta para el resultado: los espacios alrededor del texto de las celdas están ahí para su vista, no para el programa. Escribir todo eso a mano se vuelve pesado a partir de unas pocas filas y la alineación se descuadra enseguida.

Dos costumbres lo hacen llevadero. La primera: componga la tabla en un editor con letra de ancho fijo, donde cada carácter ocupa lo mismo; las columnas se cuadran solas ante sus ojos mientras escribe. La segunda: si sus datos ya están en una hoja de cálculo, péguelos primero en el documento, una fila por renglón, y añada después las barras verticales de una sola pasada, así no tendrá que volver a contar columnas cada vez que guarde.

Cuatro errores que todo el mundo repite

Las marcas de Markdown son sencillas, así que los fallos se concentran siempre en los mismos puntos. Cuando un texto no se parece a lo que esperaba, empiece por estos.

• El espacio olvidado: hace falta uno entre la almohadilla y el texto del título, y otro entre el guion y el texto del elemento. «#Título» no es un título; «# Título» sí lo es.
• Renglones que se pegan: dos renglones escritos uno debajo del otro cuentan como un solo párrafo en la mayoría de los entornos. Si quiere párrafos separados, deje un renglón en blanco entre ellos.
• Cuando el asterisco es de verdad un asterisco: el que sirve de llamada a una nota o el que aparece en una lista de precios puede confundirse con formato. Ponga una barra invertida delante (\*) y se queda tal como lo escribió.
• Confundir imagen con enlace: una notación que empieza por corchete es un enlace; ponga un signo de admiración delante y pasa a ser una imagen. Si olvida el signo, obtiene un enlace a la dirección de la imagen en lugar de la imagen.

Preguntas frecuentes

¿Para qué sirve Markdown?

Es una manera sencilla de escribir en la que el formato se expresa dentro del propio texto con unas pocas marcas. Una palabra entre asteriscos va en negrita; un renglón que empieza con almohadilla es un título. Como el archivo es texto pelado, se abre en cualquier parte y el formato no puede perderse por el camino.

¿Cómo se abre un archivo .md?

En un editor de texto, elija Abrir en el menú Archivo y ponga la lista de tipos en «Todos los archivos»; el archivo es escritura corriente. Para verlo maquetado, ábralo en una aplicación que entienda Markdown o convierta el texto a HTML y mire el resultado en un navegador.

¿Cómo convierto Markdown a HTML?

Pegue el texto en la herramienta Markdown a HTML: los títulos, las listas y los enlaces pasan a ser etiquetas. Tome la primera salida si la página donde va a pegar ya existe, y la segunda si quiere un archivo que se muestre solo con doble clic.

¿Se pueden escribir tablas en Markdown?

En la definición original no; las tablas vienen de extensiones que añadieron ciertas plataformas, así que no se ven igual en todas partes. Compruebe primero qué reconoce el sitio donde publica y después arme las columnas con barras verticales y un renglón de separación bajo los encabezados.

¿Qué diferencia hay entre Markdown y Word?

En Word el formato se guarda en un lugar que usted no ve; en Markdown está en el texto, a la vista. Markdown viaja mejor, pero no admite maquetaciones elaboradas como varias columnas, notas al pie o números de página.

Última actualización: 27 de agosto de 2026