Guía de sintaxis Markdown
Una hoja de referencia clara para el Markdown de cada día. Cada bloque muestra la sintaxis y el resultado que obtienes.
¿Qué es Markdown?
Markdown es una forma ligera de añadir formato a texto plano. En lugar de botones y menús, usas unos pocos símbolos sencillos, como # para un encabezado o * para énfasis, que se mantienen legibles incluso como texto sin procesar.
Creado por John Gruber y Aaron Swartz en 2004, se ha convertido en el estándar para READMEs, documentación, notas y sitios como GitHub y Reddit. Como es solo texto, tu escritura se mantiene portátil y legible en cualquier lugar.
Esta guía cubre la sintaxis que más usarás. Abre cualquier ejemplo en Markdown Peek y pulsa la barra espaciadora para alternar entre el texto sin formato y el resultado renderizado.
Encabezados
Empieza una línea con uno a seis caracteres #. Más almohadillas significan un encabezado más pequeño y profundo.
Markdown
# Heading 1 ## Heading 2 ### Heading 3 #### Heading 4
Resultado
Heading 1
Heading 2
Heading 3
Heading 4
Negrita, cursiva y más
Envuelve el texto en símbolos para enfatizarlo. Combínalos libremente.
Markdown
**Bold text** *Italic text* ***Bold and italic*** ~~Strikethrough~~ `Inline code`
Resultado
Bold text
Italic text
Bold and italic
Strikethrough
Inline code
Listas
Usa un guion, asterisco o signo más para viñetas, y números para listas ordenadas. Sangra para anidar.
Markdown
- First item - Second item - Nested item - Third item 1. Step one 2. Step two
Resultado
- First item
- Second item
- Nested item
- Third item
- Step one
- Step two
Enlaces
Pon el texto visible entre corchetes y la dirección entre paréntesis.
Markdown
[Markdown Peek](https://markdownpeek.com) <https://markdownpeek.com>
Imágenes
Una imagen es un enlace con un signo de exclamación delante. El texto entre corchetes es el texto alternativo.
Markdown
Resultado
Citas en bloque
Empieza una línea con > para citarla. Añade otro > para anidar una cita dentro de otra.
Markdown
> A quote worth remembering. > > > And a nested one.
Resultado
A quote worth remembering.
And a nested one.
Código
Envuelve el código en línea con comillas simples invertidas, y bloques enteros con comillas triples, con un nombre de lenguaje opcional.
Markdown
Use `backticks` for inline code.
```js
function hi() {
console.log("Hello");
}
```Resultado
Use backticks for inline code.
function hi() {
console.log("Hello");
}Tablas
Separa las columnas con barras verticales y subraya la fila de encabezado con guiones. Los dos puntos definen la alineación.
Markdown
| Feature | Supported | |---------|:---------:| | Tables | Yes | | Code | Yes |
Resultado
| Feature | Supported |
|---|---|
| Tables | Yes |
| Code | Yes |
Líneas horizontales
Tres o más guiones, asteriscos o guiones bajos en su propia línea dibujan un separador.
Markdown
Above the line. --- Below the line.
Resultado
Above the line.
Below the line.
Listas de tareas
Un elemento de lista con [ ] es una tarea abierta, y [x] es una tarea hecha.
Markdown
- [x] Read the guide - [ ] Set as default app
Resultado
- Read the guide
- Set as default app
Escapar caracteres
Pon una barra invertida antes de un símbolo para mostrarlo literalmente en lugar de como formato.
Markdown
\*Not italic\* \# Not a heading
Resultado
*Not italic*
# Not a heading
Matemáticas con LaTeX
Envuelve LaTeX entre signos de dólar simples para matemáticas dentro de una frase, o entre signos de dólar dobles para una fórmula en su propia línea. Markdown Peek renderiza ambos, sin conexión.
Markdown
Inline math like $E = mc^2$ works in a sentence. $$ a^2 + b^2 = c^2 $$
Resultado
Inline math like E = mc2 works in a sentence.
a2 + b2 = c2
Diagramas con Mermaid
Abre un bloque de código delimitado con mermaid y describe un diagrama de flujo o de secuencia en texto plano. Markdown Peek lo dibuja por ti, en modo claro u oscuro.
Markdown
```mermaid flowchart LR A[Write] --> B[Preview] B --> C[Share] ```
Resultado
Lee Markdown con estilo en tu Mac
Markdown Peek renderiza cualquier archivo .md en un limpio estilo GitHub, con Quick Look en el Finder y guardado en PDF. Gratis en la Mac App Store.
