Referencia de sintaxis

Sintaxis de Markdown: los patrones que más usarás

Puedes escribir Markdown útil con un pequeño conjunto de patrones. Empieza con una estructura semántica, deja líneas en blanco alrededor de los elementos de bloque y previsualiza el documento en el renderizador donde se publicará.

Lectura de 8 minutos

Encabezados y párrafos

Antepón de uno a seis caracteres de almohadilla a un encabezado. Usa un único H1 para el título del documento y desciende por los niveles sin elegir los encabezados solo por su tamaño visual. Los párrafos se separan con una línea en blanco.

EncabezadosMarkdown
# Document title

An opening paragraph.

## Installation

Setup details.

### Environment variables

Configuration details.

Énfasis, enlaces e imágenes

Usa asteriscos para el énfasis, corchetes para el texto visible del enlace y paréntesis para el destino. La sintaxis de imagen añade un signo de exclamación; el texto alternativo con significado sigue siendo importante cuando no se puede ver la imagen.

Sintaxis en líneaMarkdown
Use **bold** for strong importance and *italic* for emphasis.

Read the [deployment guide](/guides/deploy).

![A diagram of the request flow](request-flow.png)

Listas y listas de tareas

Empieza los elementos no ordenados con un guion y los ordenados con un número. Indenta los elementos anidados de forma coherente. Muchas plataformas de desarrollo también admiten casillas de verificación de listas de tareas mediante GitHub Flavored Markdown.

ListasMarkdown
- Prepare the release
  - Update the changelog
  - Freeze migrations
- Deploy

1. Start the canary
2. Watch metrics
3. Expand traffic

- [x] Tests pass
- [ ] Docs reviewed

Código en línea y bloques de código con vallas

Envuelve identificadores o comandos cortos entre comillas invertidas simples. Coloca ejemplos más largos entre vallas de triple comilla invertida y añade el nombre del lenguaje cuando el renderizador admita resaltado de sintaxis. Mantén los ejemplos ejecutables lo bastante completos para entenderlos y probarlos.

CódigoMarkdown
Set `SERVICE_URL` in the server environment.

```ts
type Result = {
  markdown: string;
  fileName: string;
};
```

Citas, líneas divisorias y tablas

Las citas son útiles para material citado o avisos breves. Las líneas divisorias horizontales separan transiciones importantes. Las tablas funcionan para datos rectangulares y compactos; se vuelven difíciles de leer cuando las celdas contienen prosa larga o cuando la tabla es muy ancha.

Tabla GFMMarkdown
> Conversion preserves structure, not pixel-perfect layout.

---

| Format | Good for | Review |
| --- | --- | --- |
| DOCX | Styled prose | Tables |
| CSV | Small datasets | Escaping |

Escribe una sintaxis que sobreviva a distintos renderizadores

Deja líneas en blanco alrededor de encabezados, listas, tablas y bloques de código con vallas. Prefiere enlaces descriptivos a URL desnudas. Evita el HTML sin procesar salvo que el sistema de publicación lo admita e higienice explícitamente. Cuando una función sea específica de una plataforma, incluye suficiente texto plano para que el documento siga teniendo sentido en otros lugares.

Una vista previa responde a cómo se renderiza aquí el documento; tu repositorio o sistema de documentación de destino sigue siendo la prueba de compatibilidad final.

Practica la sintaxis con vista previa en vivo

Abre un borrador local y observa cómo se renderizan encabezados, listas, código y tablas mientras escribes.

Probar el editor