PortalTec

Archivos, fotos y documentos

Markdown: escribe con formato usando solo texto

Markdown permite dar formato al texto con símbolos sencillos. La sintaxis básica con ejemplos y los programas donde se usa.

Publicado el

Mujer escribiendo en un cuaderno con un bolígrafo
Foto: Kristin Hardwick · dominio público (CC0) · vía Wikimedia Commons

Markdown es una forma de escribir texto con formato —títulos, negritas, listas, enlaces— usando solo caracteres normales del teclado. Un archivo Markdown (.md) es un simple texto que cualquier programa puede abrir, y herramientas o webs lo convierten en una página bonita.

Lo que escribes y lo que se ve.Markdown: # Título; **negrita**; no, elemento de lista. Resultado: Un título grande; negrita; Un punto de listaCOMPARATIVAMarkdown# Título**negrita**elemento de listaResultadoUn título grandenegritaUn punto de lista
Lo que escribes y lo que se ve.

Por qué usarlo

  • Es rápido: no sueltas el teclado para buscar botones.
  • Es ligero y duradero: es texto plano, no depende de ningún programa ni versión.
  • Es el estándar en GitHub (los archivos README.md), en documentación técnica y en muchas aplicaciones de notas.

Sintaxis básica

Títulos, con almohadillas:

# Título principal
## Subtítulo
### Apartado

Énfasis:

*cursiva*  o  _cursiva_
**negrita**
~~tachado~~   (en la mayoría de editores)

Listas:

- Elemento
- Otro elemento

1. Primero
2. Segundo

Enlaces e imágenes:

[texto del enlace](https://ejemplo.com)
![descripción de la imagen](foto.jpg)

Citas y código:

> Esto es una cita

`código en línea`

Tablas (en la variante más extendida, la de GitHub):

| Nombre | Edad |
|--------|------|
| Ana    | 30   |
| Luis   | 25   |
Dónde se usa Markdown.Sí: GitHub y GitLab. Sí: Obsidian, Notion y Joplin. Sí: Visual Studio Code, con vista previa. Sí: Muchos generadores de websLISTA RÁPIDAProgramas que lo entiendenGitHub y GitLabObsidian, Notion y JoplinVisual Studio Code, con vista previaMuchos generadores de webs
Dónde se usa Markdown.

Dónde se usa

  • Notas: Obsidian, Notion, Joplin, Bear y otras aceptan Markdown.
  • Editores de código: Visual Studio Code muestra una vista previa con Ctrl+Mayús+V (primeros pasos con VS Code).
  • GitHub y GitLab: los README, las incidencias y los comentarios (primeros pasos con Git y GitHub).
  • Blogs y webs estáticas: muchos generadores convierten Markdown en páginas HTML.

De Markdown a PDF o Word

Hay varias formas: abrir la vista previa del editor e imprimir a PDF, usar una herramienta como Pandoc (de línea de comandos) o pegar el resultado en Word. Si necesitas un formato final para enviar, repasa DOCX, ODT o PDF: qué formato usar.

En Visual Studio Code, la vista previa de un archivo .md.Ctrl + Mayús + V: Abre la vista previa de MarkdownATAJOSCtrl+Mayús+VAbre la vista previa de Markdown
En Visual Studio Code, la vista previa de un archivo .md.

Un consejo

Existen pequeñas variantes de Markdown (CommonMark, GitHub Flavored Markdown…). Lo básico —títulos, listas, negritas y enlaces— funciona igual en todas; las tablas, el tachado o las listas de tareas dependen de la variante que admita tu programa. Compara dos versiones de un texto con comparar textos.