Un archivo .md es un archivo de texto plano con la extensión de Markdown. No necesitas ningún programa especial para crearlo: cualquier editor de texto sirve, incluido el que ya viene instalado en tu sistema.

Esa es toda la magia del formato. A diferencia de un documento de Word, que es un contenedor binario que solo entienden ciertos programas, un archivo Markdown lo puede abrir cualquier cosa que lea texto. Lo único que cambia respecto a un .txt normal es la extensión, que le indica a las aplicaciones que el contenido usa la sintaxis de Markdown.

Qué es realmente un archivo .md

Antes de crear el primero conviene entender qué estás creando, porque evita la mitad de los problemas habituales.

Un archivo .md contiene texto y nada más. Cuando escribes **negrita**, en el archivo se guardan literalmente esos asteriscos junto a la palabra. El formato no está incrustado en el archivo como en un procesador de textos: es la aplicación que lo muestra la que interpreta los símbolos y los convierte en negrita al renderizar.

Por eso el mismo archivo se ve como texto con asteriscos en el Bloc de notas y con formato en GitHub. El archivo es idéntico, lo que cambia es quién lo lee. También existe la extensión .markdown, menos habitual pero igual de válida.

Crear un archivo .md desde el explorador de archivos

Esta es la vía más directa si no quieres instalar nada, aunque tiene una trampa en Windows que conviene conocer.

En Windows

Antes de nada, activa la visualización de extensiones en el Explorador de archivos, en la pestaña de vista. Sin esto no verás si tu archivo se llama realmente notas.md o notas.md.txt, que es el error más común.

Después abre el Bloc de notas, escribe algo y usa la opción de guardar como. En el desplegable del tipo de archivo elige la opción de todos los archivos y escribe el nombre con su extensión.

notas.md

Si dejas el tipo de archivo en documento de texto, Windows añadirá .txt al final aunque tú hayas escrito .md, y acabarás con un notas.md.txt que ninguna aplicación reconocerá como Markdown.

En macOS

TextEdit tiene su propia trampa: por defecto trabaja en modo texto enriquecido y guardaría un .rtf disfrazado. Antes de escribir nada, ve al menú de formato y convierte el documento a texto plano.

Con el documento ya en texto plano, guárdalo con la extensión .md. El sistema preguntará si de verdad quieres usar esa extensión en vez de .txt, y ahí le dices que sí.

En Linux

Cualquier editor de texto del escritorio sirve sin configuración previa, ya sea gedit, Kate, Mousepad o el que traiga tu distribución. Escribe el contenido y guarda el archivo poniéndole la extensión .md en el nombre.

Crear un archivo .md desde la terminal

Si te manejas con la línea de comandos, esta es la forma más rápida de todas y funciona igual en Linux, macOS y en Windows con PowerShell o WSL.

Para crear un archivo vacío basta con un comando:

touch notas.md

Si quieres crearlo ya con contenido, puedes volcarlo directamente:

echo "# Mis notas" > notas.md

Y para crear un archivo con varias líneas de golpe, usa un bloque de texto:

cat > notas.md << 'EOF'
# Mis notas

Este es mi primer documento en Markdown.

- Primer elemento
- Segundo elemento
EOF

También puedes abrir directamente un editor de terminal como nano o vim, que crearán el archivo al guardar si no existe:

nano notas.md

Crear un archivo .md en Visual Studio Code

VS Code es probablemente la forma más cómoda de trabajar con Markdown en el día a día, porque previsualiza el resultado sin instalar nada.

Crea un archivo nuevo, escribe el contenido y guárdalo con la extensión .md. En cuanto lo guardes, el editor reconocerá el formato y activará el resaltado de sintaxis.

Para ver el resultado renderizado, abre la vista previa con Ctrl+Shift+V, o Cmd+Shift+V en macOS. Si prefieres verla al lado del editor y que se actualice mientras escribes, usa Ctrl+K seguido de V. Tienes más detalles en nuestro artículo sobre Markdown en VS Code.

Cómo crear un archivo .md en GitHub

En GitHub no necesitas descargar el repositorio ni usar Git: puedes crear el archivo desde el navegador.

Crear el archivo desde la web

Dentro del repositorio, usa el botón de añadir archivo y elige la opción de crear uno nuevo. En el campo del nombre escribe el nombre con su extensión.

documentacion.md

Escribe el contenido en el editor, que incluye una pestaña de vista previa para comprobar cómo quedará. Al terminar, confirma los cambios con el botón de commit del final de la página.

El caso especial del README

Si nombras el archivo README.md y lo colocas en la raíz del repositorio, GitHub lo mostrará automáticamente renderizado en la página principal. Es el archivo Markdown más importante de cualquier proyecto y merece la pena dedicarle tiempo.

Cuando un repositorio no tiene README, GitHub ofrece un botón para crearlo directamente desde la portada del proyecto. Tienes una guía completa en cómo escribir un README perfecto, y una plantilla de README lista para copiar.

Crear carpetas por el camino

Un detalle poco conocido del editor web: si al escribir el nombre del archivo incluyes una barra, GitHub crea la carpeta automáticamente.

docs/instalacion.md

Esto crea la carpeta docs y dentro el archivo, todo en el mismo paso. Ten en cuenta que GitHub aplica su propia variante del formato, GitHub Flavored Markdown, que añade tablas, tareas y resaltado de código sobre la sintaxis básica.

Cómo guardar un archivo Markdown correctamente

Al guardar hay tres cosas que conviene revisar, sobre todo si el archivo lo van a leer otras personas u otras herramientas.

La extensión debe ser .md y nada más. Comprueba que no se haya colado un .txt detrás, que es lo que ocurre cuando el editor guarda con el tipo de archivo equivocado.

La codificación debe ser UTF-8. Es la opción por defecto en prácticamente todos los editores modernos, pero si abres un archivo antiguo y ves símbolos raros donde deberían ir las tildes y las eñes, el problema es este. Guardar en UTF-8 lo resuelve.

El nombre del archivo conviene que vaya en minúsculas, sin espacios ni acentos. Usa guiones para separar palabras. Esto importa porque en Linux y en la mayoría de servidores web las mayúsculas y minúsculas no son intercambiables, y un enlace a Mis Notas.md puede funcionar en tu ordenador y romperse al publicarlo.

correcto:   guia-de-instalacion.md
incorrecto: Guía de Instalación.md

Errores comunes al crear el archivo

Estos son los tropiezos que se repiten y cómo se resuelven.

• El archivo se llama notas.md.txt: el editor añadió su extensión por defecto. Activa la visualización de extensiones y renombra el archivo.
• Se ve el texto con asteriscos en vez de negrita: es lo normal en un editor de texto plano. Necesitas una aplicación que renderice, no que solo muestre.
• Las tildes salen como símbolos extraños: el archivo no está en UTF-8. Vuelve a guardarlo eligiendo esa codificación.
• TextEdit guarda un archivo que nadie abre: seguía en modo texto enriquecido. Conviértelo a texto plano antes de guardar.
• El archivo se abre con el programa equivocado al hacer doble clic: es cuestión de la asociación de archivos del sistema, no del archivo. Elige con qué aplicación abrirlo desde el menú contextual.

Cómo abrir y previsualizar el archivo

Un archivo .md se abre con cualquier editor de texto, pero para ver el resultado con formato necesitas algo que lo renderice.

La opción sin instalar nada es subirlo a GitHub o pegarlo en un editor online. Si vas a trabajar con Markdown a menudo, mejor instala una aplicación de Markdown con vista previa, como Obsidian, Typora o el propio Visual Studio Code.

Y si lo que necesitas es entregar el documento en otro formato, tienes nuestros conversores de Markdown a PDF, Markdown a DOCX y Markdown a HTML.

Qué escribir dentro

Ya tienes el archivo creado. Este sería un contenido mínimo para empezar:

# Titulo del documento

Un parrafo de introduccion con **texto en negrita** y *cursiva*.

## Una seccion

- Primer elemento de la lista
- Segundo elemento

1. Un paso
2. Otro paso

[Un enlace](https://ejemplo.com)

Y este es el resultado al renderizarlo:

A partir de aquí, lo siguiente es la sintaxis básica de Markdown, o la guía rápida si prefieres tenerlo todo resumido en una página.

Y con esto ya hemos terminado. Espero que te haya resultado de ayuda.