Archivos .md: qué son y cómo utilizarlos

Autor: Publicado

En breve: Un archivo .md suele ser un archivo de texto plano escrito en Markdown, una forma sencilla de marcar encabezados, listas, enlaces y otros elementos de un documento. Puedes abrirlo en cualquier editor de texto, y un programa compatible con Markdown también te mostrará la versión con formato. Estos archivos se utilizan a menudo para crear instrucciones, notas, documentación y contenido de páginas web.

¿Qué significa la extensión .md?

La extensión .md, es decir, la terminación del nombre del archivo, suele indicar que está escrito en Markdown. Se trata de un lenguaje de marcado ligero: en lugar de elegir el formato desde una barra de herramientas, introduces símbolos sencillos en el texto. Por ejemplo, dos asteriscos a cada lado de una palabra indican que debe mostrarse en negrita.

El documento sigue siendo legible sin necesidad de un programa específico. En un editor de texto verás las palabras y las marcas; en la vista previa de Markdown, el contenido con formato. El proceso de convertir las marcas en la apariencia visual del documento se llama renderizado.

A diferencia de un archivo .docx, un documento Markdown no almacena una maquetación compleja, como la colocación precisa de los elementos o los ajustes de impresión. Se centra en el contenido y su estructura. Sin embargo, la extensión por sí sola no garantiza el contenido: un archivo puede recibir cualquier nombre, por lo que un documento .md atípico no tiene por qué contener texto Markdown válido.

¿Cómo abrir un archivo .md y verlo con formato?

Para leer el contenido basta con un editor de texto plano, como el Bloc de notas del sistema. Es una buena opción si quieres consultar rápidamente unas instrucciones o corregir una frase. En ese caso también verás los símbolos que definen el formato.

Si buscas trabajar con comodidad, elige una herramienta con vista previa de Markdown:

Si al hacer doble clic en el archivo no se abre el programa adecuado, utiliza la opción «Abrir con» y selecciona un editor de texto. No necesitas cambiar la extensión a .txt. Un navegador web por sí solo no siempre mostrará un archivo local .md con formato: puede mostrar su contenido sin procesar u ofrecer la descarga.

¿Cómo es la sintaxis de Markdown en la práctica?

Puedes aprender las marcas básicas con una nota breve. El siguiente fragmento contiene un encabezado de segundo nivel, negrita, una lista y una marca de código:

## Preparación de la página

**Antes de publicar**, comprueba:

- que los datos de contacto sean correctos,
- que el formulario funcione,
- cómo se ve la página en el móvil.

El archivo de inicio del proyecto es `index.html`.

En la vista previa, los signos ## darán paso a un encabezado, los asteriscos pondrán las palabras en negrita y los guiones crearán una lista con viñetas. Los acentos graves que rodean index.html destacarán el nombre como un fragmento de código. Una línea en blanco separa los párrafos o los bloques de contenido más amplios.

Un enlace se escribe siguiendo el esquema [texto del enlace](direccion), y una imagen, el esquema ![descripción de la imagen](ruta-al-archivo). Normalmente, la imagen no está incrustada en el propio documento .md: el texto indica dónde se encuentra. Por eso, al trasladar el documento también hay que tener en cuenta los archivos de imagen y comprobar que las rutas sean correctas.

Existen distintas variantes de Markdown, cada una con sus reglas para interpretar las marcas. Los encabezados y las listas básicos tienen una amplia compatibilidad, pero las tablas, las listas de tareas o las notas al pie pueden funcionar de forma distinta según el programa. Si el documento se va a usar en un sistema concreto, comprueba la vista previa en ese mismo sistema.

¿Cómo crear un archivo .md y compartirlo con otra persona?

Puedes preparar un documento nuevo sin instalar software especializado:

  1. Abre un editor de texto plano y escribe el contenido con marcas Markdown.
  2. Elige guardarlo como archivo de texto, preferiblemente con codificación UTF-8, para conservar los caracteres polacos.
  3. Asígnale un nombre, por ejemplo, instrucciones.md.
  4. Comprueba que el programa no haya añadido automáticamente la extensión .txt, creando instrucciones.md.txt.
  5. Abre el documento en una vista previa de Markdown y revisa el formato.

Cambiar el nombre de un archivo de Word de instrucciones.docx a instrucciones.md no convierte el documento. Debes exportar el contenido con una herramienta adecuada o pegarlo como texto plano y añadir las marcas.

Si la persona que lo recibe necesita editar las instrucciones, comparte el archivo .md junto con las imágenes utilizadas. Si solo necesita leer el documento terminado, puede resultar más cómodo un PDF exportado desde un programa compatible con Markdown. Los formatos de exportación disponibles dependen de la herramienta elegida.

¿Cuándo es Markdown una buena opción?

Markdown resulta útil cuando el contenido importa más que la maquetación: en notas, instrucciones y documentación técnica. El habitual archivo README.md suele describir el proyecto, cómo ponerlo en marcha o las normas de uso. Como se trata de texto plano, es fácil comparar versiones sucesivas e identificar las frases modificadas.

Los archivos .md también pueden servir como fuente de artículos en generadores de sitios web, como Hugo. Estos sistemas convierten el contenido en una página web y le dan una apariencia según una plantilla. Sin embargo, un archivo Markdown por sí solo no es un sitio web listo para usar.

Para un documento que requiera una disposición precisa al imprimir, tablas complejas o la colocación manual de los elementos, será más adecuado un procesador de textos o un programa de maquetación. Para empezar, crea una nota breve .md y ábrela a la vez como texto y en una vista previa: verás enseguida la diferencia entre las marcas y su resultado.

Consulta también: ¿Qué es 2FA?

Lee también

Descubre cómo PHP-FPM atiende peticiones PHP, en qué se diferencia de un servidor web y cómo ajustar sus procesos al tráfico y los recursos.
Conoce BIND, el software abierto de servidor DNS: sus funciones, cómo gestiona dominios y cuándo conviene instalarlo por tu cuenta.
Descubre qué son el registro REGON de Polonia y su número, en qué se diferencian de NIP y KRS y cómo verificar los datos de una empresa.