La hoja de trucos de rebajas más completa en línea

La hoja de trucos de rebajas más completa en línea. Cada elemento de sintaxis con ejemplos, resultados renderizados, compatibilidad de plataformas, errores comunes y consejos de expertos. Márcalo como favorito.

Benjamin McBrayer // Publicado: 21 de abril de 202618 min de lectura

También en

English Deutsch Français Italiano Português

Markdown es una forma sencilla de formatear texto utilizando símbolos como hashtags, asteriscos y corchetes. Es útil para escritores, blogueros, desarrolladores, estudiantes y cualquiera que cree contenido en línea, porque hace que el formato sea rápido, limpio y fácil de reutilizar en diferentes plataformas. Esta hoja de trucos de Markdown te mostrará las reglas más comunes para que puedas escribir y publicar en Markdown a partir de ahora.

¿Qué es la rebaja?

Markdown es un lenguaje de marcado ligero que le permite utilizar símbolos de texto sin formato para formatear documentos. Cuando escribe **negrita**, aparece en negrita. Cuando escribe # Encabezado, se convierte en un encabezado. Cuando usas Markdown, se convierte a HTML. Funciona prácticamente en todas las plataformas y se ha convertido en el idioma predeterminado para formatear en miles de herramientas, plataformas y sitios web, incluidos GitHub, Reddit, Discord, Notion, Slack y Obsidian.

Por qué es importante el descuento

John Gruber creó Markdown en 2004 con el objetivo de permitir a las personas escribir y formatear documentos usando texto sin formato sin mirar un montón de etiquetas. Hoy en día, Markdown se ha convertido en un lenguaje utilizado por prácticamente todos los desarrolladores y creadores, así como por los redactores de contenido y otros.

Los beneficios de las rebajas

Markdown es tan popular porque resuelve muchos problemas que planteaban los formatos anteriores.

Markdown funciona en todas partes y siempre lo hará: Puede abrir un archivo .md en cualquier editor de texto y en cualquier sistema operativo, y podrá abrirlo dentro de 50 años.
Puedes leer Markdown sin renderizarlo: A diferencia de RTF o HTML, Markdown es un formato que es legible en su forma original, no solo después de renderizarlo.
Es rápido trabajar con Markdown: Los escritores experimentados pueden formatear el texto a medida que lo escriben y trabajar más rápido.
Markdown es universal: Como se mencionó anteriormente, muchas plataformas usan Markdown de forma nativa.

Hoy en día, es importante conocer Markdown para cualquiera que esté creando algo con herramientas de inteligencia artificial, porque los LLM generan Markdown de forma predeterminada.

Sintaxis básica de rebajas

Estos elementos provienen de la especificación original de 2004 de John Gruber. Todos los analizadores de rebajas los admiten, con pequeñas diferencias de implementación que se indican a continuación.

Tabla de referencia rápida

Elemento	Sintaxis de rebajas
Encabezado de rebajas	`# H1` `## H2` `### H3`
Rebaja en negrita	`negrita` o `__negrita__`
Rebaja cursiva	`cursiva` o `_italic_`
Rebajas Negrita + Cursiva	`*negrita cursiva*`
Cita en bloque de rebajas	`> texto citado`
Lista ordenada de rebajas	`1. Artículo`
Lista desordenada de rebajas	`- Artículo` o `* Artículo` o `+ Artículo`
Código en línea de rebajas	`código`
Bloque de código de rebajas	Sangrar 4 espacios o utilizar bloques vallados
Regla horizontal de rebajas	`---` o `***` o `___`
Enlace de rebajas	`[texto](https://ejemplo.com)`
Imagen de rebajas	`![texto alternativo](imagen.jpg)`
Salto de línea de rebajas	Terminar una línea con dos espacios finales
Carácter de escape de rebajas	`\asterisco literal\`

Encabezados de rebajas

Utilice signos de 1 a 6 libras (#) seguidos de un espacio. El número de signos coincide con el nivel del título HTML.

# Heading 1
## Heading 2
### Heading 3
#### Heading 4
##### Heading 5
###### Heading 6

Sintaxis alternativa (estilo Setext) funciona solo para H1 y H2:

Heading 1
=========

Heading 2
---------

Mejores prácticas:

Siempre coloque un espacio entre # y el texto del encabezado. #Heading funciona en algunos analizadores pero falla en otros.
Utilice sólo un H1 por documento (normalmente el título de la página).
No te saltes los niveles de encabezado. Vaya H1 → H2 → H3, no H1 → H3.
Agregue líneas en blanco antes y después de los títulos para una máxima compatibilidad.

Rebaja Negrita, Cursiva y Énfasis

**This is bold** and __this is also bold__
*This is italic* and _this is also italic_
***Bold and italic*** combined

Se representa como:

Esto está en negrita y esto también está en negrita Esto está en cursiva y esto también está en cursiva Negrita y cursiva combinadas

Entendido: Algunos analizadores no manejan guiones bajos en medio de una palabra. Para obtener la máxima compatibilidad, utilice asteriscos para enfatizar la mitad de la palabra: "in**creíble", no "increíble".

Cotizaciones en bloque de rebajas

Comience cualquier línea con > para crear una [cita de bloque de rebajas] (/blog/markdown-blockquotes-guide).

> This is a single-line blockquote.

> This is a blockquote
> that spans multiple lines.

> Blockquotes can be nested.
>
> > Like this.
>
> And they can contain **other markdown** elements.

Las citas en bloque de Markdown funcionan bien para enfatizar citas, leyendas y formato de estilo de respuesta en correos electrónicos.

Listas de rebajas

Las listas desordenadas aceptan -, * o + indistintamente. Elija un estilo y manténgalo para mantener la coherencia.

- First item
- Second item
- Third item
  - Nested item (indent two or four spaces)
  - Another nested item
- Fourth item

Listas ordenadas utilizan números seguidos de un punto:

1. First item
2. Second item
3. Third item

Truco útil: Los números no tienen por qué ser correctos. Markdown vuelve a numerarse automáticamente:

1. First
1. Second
1. Third

…se representa de manera idéntica a 1, 2, 3. Esto significa que puede reordenar artículos sin tener que volver a numerarlos.

Anidamiento de listas de rebajas ordenadas y desordenadas:

1. First step
2. Second step
   - Sub-bullet
   - Another sub-bullet
3. Third step
   1. Sub-step
   2. Another sub-step

Enumera elementos con varios párrafos: Sangra la continuación con el mismo número de espacios (normalmente 4 o una tabulación):

1. First item

    This paragraph belongs to the first item.
    Notice the blank line above and the indent.

2. Second item

Enlaces de rebajas

Los enlaces en línea son el estilo más común:

[Visit Google](https://www.google.com)
[With hover title](https://www.google.com "Google's homepage")

Los enlaces de rebajas de estilo de referencia son útiles cuando la misma URL aparece varias veces o cuando desea mantener la prosa limpia:

I love [Obsidian][1] and [VS Code][vscode] for markdown.

[1]: https://obsidian.md
[vscode]: https://code.visualstudio.com

URL automáticas. Incluya una URL simple entre corchetes angulares:

<https://example.com>
<hello@example.com>

Enlaces relativos. Enlace a archivos en el mismo repositorio o carpeta:

[Read the license](./LICENSE.md)
[Parent directory file](../README.md)

Enlaces de anclaje de Markdown. Saltar a un encabezado en la misma página. La mayoría de los analizadores generan automáticamente ID a partir del texto del encabezado (minúsculas, espacios y guiones):

Jump to [the installation section](#installation).

## Installation

Imágenes de rebajas

La sintaxis de la imagen Markdown es la sintaxis del enlace con un signo de exclamación inicial:

![Descriptive alt text](/path/to/image.jpg)
![Alt text](/path/to/image.jpg "Optional hover title")

Las imágenes de rebajas de estilo de referencia funcionan de la misma manera que los enlaces de referencia:

![Company logo][logo]

[logo]: /images/logo.png "Our logo"

Hacer de una imagen de descuento un enlace:

[![Alt text](image.jpg)](https://example.com)

Tamaño de imágenes. Pure Markdown no tiene sintaxis para esto. Utilice HTML en línea como alternativa:

<img src="image.jpg" alt="Alt text" width="400">

Nota de accesibilidad: Escribe siempre texto alternativo significativo. Los lectores de pantalla dependen de ello y los motores de búsqueda lo utilizan para comprender el contenido de la imagen. ![](logo.png) es malo; ![Logotipo de la empresa, círculo azul con una M blanca](logo.png) es bueno.

Código de rebajas

Código de rebajas en línea se ajusta con comillas invertidas simples:

Install with `npm install markdown-it`.

Bloques de código de rebajas. Sangra cada línea con cuatro espacios (o una tabulación):

    function hello() {
      console.log("Hello, world!");
    }

En la práctica, casi todo el mundo utiliza bloques de código delimitados (que se tratan en la sección de sintaxis extendida a continuación) porque admiten el resaltado de sintaxis.

Escapar de comillas invertidas dentro del código en línea. Utilice más comillas invertidas en el exterior:

To show a backtick, use `` `backtick` `` like this.

Reglas horizontales de rebajas

Tres o más guiones, asteriscos o guiones bajos en su propia línea:

---
***
___

Los tres se renderizan de manera idéntica. Coloque líneas en blanco antes y después para compatibilidad.

Saltos de línea de rebajas

Esta es una de las características más confusas de Markdown. Hay tres comportamientos diferentes:

Salto de párrafo. Deje una línea en blanco entre el texto:

This is paragraph one.

This is paragraph two.

Salto de línea (mismo párrafo). Finalice una línea con dos espacios al final:

This line ends with two spaces.␣␣
This line is a break within the same paragraph.

Reserva HTML. Utilice <br> cuando los espacios finales parezcan demasiado frágiles:

This line has an HTML break.<br>
This is the next line.

Por qué los espacios finales son controvertidos: Son invisibles. La mayoría de los editores los eliminan al guardar. GitHub Flavored Markdown (GFM) resuelve este problema al tratar cualquier nueva línea como un salto de línea dentro de un párrafo, pero el CommonMark estándar requiere los espacios finales.

Caracteres de escape de rebajas

Para mostrar un carácter que Markdown normalmente interpretaría como formato, precedido por una barra invertida:

\*This shows literal asterisks\*
\# This shows a literal hash sign
\[not a link\]

Caracteres que se pueden evitar: \ ` * _ {} [] () # + - . ! |

Sintaxis de rebajas extendida

Estos elementos no están en la especificación original de Gruber, pero los procesadores de rebajas más utilizados los admiten, incluidos GitHub, GitLab, Reddit, Stack Overflow, Obsidian, Notion y Discord. La compatibilidad varía, así que consulte la matriz a continuación antes de confiar en cualquiera de ellos.

Tabla de referencia rápida

Elemento	Sintaxis de rebajas
Tabla de rebajas	`\| Encabezado \| Encabezado \|` + `\| ---\| --- \|`
Bloque de código vallado con rebajas	```idioma ...```
Resaltado de sintaxis de Markdown	Nombre del idioma después de abrir la valla
Nota al pie de rebajas	`Aquí hay una nota.[^1]` ... `[^1]: Texto de la nota.`
ID de encabezado de rebajas	`### Mi encabezado {#custom-id}`
Lista de definiciones de rebajas	`término` nueva línea `: definición`
Tachado de rebajas	`~~texto eliminado~~`
Lista de tareas de rebajas	`- [x] Listo` `- [ ] Todo`
Código corto de emoji de rebajas	`:alegría:` `:cohete:`
Resaltado de rebajas	`==resaltado==`
Subíndice de rebajas	`H~2~O`
Superíndice de rebajas	`E = mc^2^`
URL automática de rebajas	`<https://ejemplo.com>`
Alertas de rebajas de GitHub	`> [!NOTE]` `> [!WARNING]` `> [!TIP]`

Tablas de rebajas

Utilice barras verticales (|) para las columnas y una fila de guiones para el separador del encabezado.

| Name     | Role       | Location      |
| -------- | ---------- | ------------- |
| Alice    | Developer  | Berlin        |
| Bob      | Designer   | Montreal      |
| Carol    | Writer     | Sydney        |

Alineación de columnas. Agregue dos puntos a la fila separadora:

| Left-aligned | Centered     | Right-aligned |
| :----------- | :----------: | ------------: |
| apples       | bananas      |          $100 |
| cherries     | dates        |           $12 |

Consejos que la mayoría de las guías pasan por alto:

No necesitas alinear las tuberías en tu fuente. El renderizador maneja el espaciado.
Los tubos exteriores son opcionales, pero agregarlos ayuda con la legibilidad y los complementos de edición.
Puede utilizar rebajas básicas dentro de las celdas (**negrita**, *cursiva*, `código`, enlaces).
No puedes utilizar elementos de bloque (encabezados, citas en bloque, listas) dentro de las celdas.
Para contenido de varias líneas dentro de una celda, use <br> en lugar de un salto de línea.
Para mostrar un carácter de barra vertical dentro de una celda, use la entidad HTML |.

Bloques de código vallados con rebajas

Tres comillas invertidas (o tildes) abren y cierran un bloque. Agregue un identificador de idioma después de la valla de apertura para resaltar la sintaxis:

```pitón
saludo definido (nombre):
    return f"¡Hola, {nombre}!"

imprimir(saludar("mundo"))```

Identificadores de lenguaje común: python, javascript, typescript, bash, shell, sql, json, yaml, html, css, rust, go, java, c, cpp, csharp, php, ruby, swift, kotlin, dart, r, scala, diff.

Mostrando cambios de código con diff:

```diferencia
- const old = "eliminar esto";
+ const nuevo = "agregar esto";```

Escapando de triples acentos graves. Envuelve el bloque en cuatro acentos graves:

````
Este bloque contiene```triple backticks```adentro.````

Notas al pie de rebajas

Las notas al pie de Markdown son perfectas para citas, apartes y notas explicativas sin saturar tu prosa.

Here is a statement that needs a source.[^1]

Here is another claim.[^detailed-note]

[^1]: This is a short footnote.
[^detailed-note]: Named footnotes still render as numbers, but they're
    easier to track in the source. They can span multiple lines if you
    indent the continuation.

ID de encabezado de rebajas

Algunos analizadores le permiten asignar ID personalizados a los encabezados para establecer enlaces de anclaje precisos:

### My Great Heading {#custom-heading-id}

Jump to [my heading](#custom-heading-id).

GitHub y muchos otros generan automáticamente ID a partir del texto del encabezado, por lo que normalmente no es necesario.

Listas de definiciones de rebajas

Markdown
: A lightweight markup language for formatting plain text.

HTML
: The standard markup language for web pages.

CSS
: The language used to style HTML documents.

El apoyo es irregular. Funciona en Pandoc, PHP Markdown Extra y algunos otros, pero no en GFM estándar.

Tachado de rebajas

Ajusta el texto con dos tildes para tacharlo:

~~This text is struck through.~~

Se representa como: ~~Este texto está tachado.~~

Funciona en GFM, Reddit, Discord, Slack y los procesadores más utilizados. No en CommonMark estándar.

Listas de tareas de rebajas

Casillas de verificación interactivas, comúnmente utilizadas en problemas de GitHub, solicitudes de extracción y tableros de proyectos:

- [x] Write the first draft
- [x] Edit for clarity
- [ ] Publish the article
- [ ] Promote on social media
  - [ ] Twitter
  - [ ] LinkedIn
  - [ ] Hacker News

En GitHub, estas se representan como casillas de verificación en las que se puede hacer clic y que puedes alternar directamente en la interfaz de usuario.

Emoji de rebajas

La mayoría de las plataformas admiten códigos cortos de emoji:

Ship it :rocket: and celebrate :tada::champagne:

También puedes pegar caracteres emoji reales directamente. Se muestran bien en cualquier archivo de rebajas ya que son solo Unicode. 🚀🎉

Resaltado de rebajas, subíndice, superíndice

I need to ==highlight== this important idea.
Water is H~2~O.
Einstein's famous equation: E = mc^2^.

El soporte es limitado. Funciona en Obsidian, MultiMarkdown y algunos analizadores extendidos, pero no en GFM.

Enlace de URL automático de Markdown

Envuelva una URL entre corchetes angulares para crear un enlace automático:

<https://example.com>
<contact@example.com>

En GitHub Flavored Markdown, cualquier URL básica se convierte automáticamente. Ni siquiera necesitas los corchetes.

Matriz de compatibilidad de plataformas

Utilice esta tabla para comprobar qué elementos de sintaxis funcionan en las plataformas que utiliza. "Sí" significa soporte total, "No" significa sin soporte y "Parcial" significa que la función funciona con limitaciones o utiliza una sintaxis no estándar.

Característica	GFM	GitLab	Reddit	Discordia	flojo	Noción	Obsidiana	Desbordamiento de pila
Encabezados	Sí	Sí	Sí	No	No	Sí	Sí	Sí
Negrita/cursiva	Sí	Sí	Sí	Sí	Parcial*	Sí	Sí	Sí
Tachado	Sí	Sí	Sí	Sí	Sí	Sí	Sí	Sí
Cita en bloque	Sí	Sí	Sí	Sí	Sí	Sí	Sí	Sí
Listas	Sí	Sí	Sí	Sí	Sí	Sí	Sí	Sí
Código en línea	Sí	Sí	Sí	Sí	Sí	Sí	Sí	Sí
Código vallado	Sí	Sí	Sí	Sí	Sí	Sí	Sí	Sí
Resaltado de sintaxis	Sí	Sí	Parcial	Parcial	No	Sí	Sí	Sí
Enlaces	Sí	Sí	Sí	Sí	Parcial**	Sí	Sí	Sí
Imágenes	Sí	Sí	Parcial	Parcial	Parcial	Sí	Sí	Sí
Mesas	Sí	Sí	Sí	No	No	Sí	Sí	Sí
Listas de tareas	Sí	Sí	No	No	No	Sí	Sí	No
Notas a pie de página	Sí	Sí	No	No	No	No	Sí	No
Códigos cortos de emojis	Sí	Sí	No	Sí	Sí	No	Parcial	No
Matemáticas (LaTeX)	Sí	Sí	No	No	No	Sí	Sí	Sí
Diagramas de sirena	Sí	Sí	No	No	No	No	Sí	No
Subrayado	No	No	No	Sí	No	Sí	Parcial	No
Texto spoiler	No	No	Sí	Sí	No	No	No	No

* Slack utiliza asteriscos simples para negrita (no dobles) y guiones bajos simples para cursiva. ** Slack usa la sintaxis <url|text> en lugar de enlaces de rebajas estándar.

Rebaja con sabor a GitHub

GitHub Flavored Markdown (GFM) es el dialecto de rebajas más influyente. Dado que GitHub es el hogar predeterminado para proyectos de código abierto, las convenciones GFM se han convertido en el estándar de facto.

GFM agrega lo siguiente además del descuento estándar:

Alertas de GitHub

Una sintaxis especial de citas en bloque para llamadas. Se admiten cinco tipos:

> [!NOTE]
> Useful information that users should know.

> [!TIP]
> Helpful advice for doing things better.

> [!IMPORTANT]
> Key information users need to know.

> [!WARNING]
> Urgent info needing immediate attention.

> [!CAUTION]
> Advises about risks or negative outcomes.

Cada uno se representa con un color e ícono distintos en GitHub.

Referencias enlazadas automáticamente de Markdown

Dentro de los repositorios de GitHub, ciertos patrones se convierten en enlaces automáticamente:

#123 → enlaces al problema o solicitud de extracción n.° 123
@nombredeusuario → menciona un usuario
org/repo#123 → enlaces a un problema en otro repositorio
a1b2c3d → enlaces a un hash de confirmación

Diagramas de sirena con rebajas

Bloques de código protegidos con "sirena" mientras el lenguaje se representa como diagramas de flujo, diagramas de secuencia y más:

```sirena
gráfico LR
    A[Inicio] --> B{Decisión}
    B -->|Sí| C[Haz la cosa]
    B -->|No| D[Saltarlo]```

Expresiones matemáticas de rebajas

GFM admite matemáticas LaTeX de dos formas:

Inline math: $E = mc^2$

Block math:

$$
\frac{n!}{k!(n-k)!} = \binom{n}{k}
$$

Rebajas específicas de la plataforma

Rebaja de discordia

Discord usa su propia variante de rebajas. Diferencias clave con respecto al estándar:

__underline__ (guiones bajos dobles) produce subrayado, no negrita
**negrita** todavía funciona
*italic* y _italic_ funcionan
||spoiler|| oculta el texto hasta que se hace clic
# Heading funciona, pero solo se admiten H1, H2 y H3
Los bloques de código y el código en línea funcionan normalmente.
Sin tablas ni imágenes mediante sintaxis de rebajas

Rebaja de holgura (mrkdwn)

El sabor de rebajas de Slack, llamado confusamente "mrkdwn", diverge significativamente:

*negrita* utiliza asteriscos simples (no dobles)
_italic_ usa guiones bajos simples
~tachado~ usa tildes simples
`código` funciona normalmente
> cita funciona normalmente
Los enlaces utilizan la sintaxis <https://example.com|texto del enlace>
Sin títulos, sin tablas, sin listas de tareas

Si estás pegando rebajas estándar en Slack, no se formateará correctamente. Convierta primero.

Rebaja de Reddit

Reddit admite la mayoría de la sintaxis estándar y extendida con algunas peculiaridades:

>!spoiler!< para texto de spoiler
^superíndice con un signo de intercalación (no es necesario un signo de intercalación para cerrar palabras individuales)
Admite tablas, tachados y bloques de código
No admite listas de tareas, notas a pie de página ni ID de encabezado personalizados

Rebaja de nociones

Notion admite la entrada de rebajas pero la convierte a su sistema de bloques. Puedes escribir Markdown para crear bloques rápidamente:

La rebaja estándar funciona durante la entrada.
Notion agrega sus propias características (bases de datos, alternancias, llamadas) que no son rebajas estándar
Pegar contenido de rebajas generalmente se importa limpiamente

Rebaja de obsidiana

Obsidian es una aplicación para tomar notas que utiliza Markdown, con varias extensiones:

[[enlaces estilo Wiki]] para enlaces internos entre notas
[[Nota#encabezado]] para vincular a un título específico en otra nota
![[Nota]] para incrustar el contenido de otra nota
> [!note] Título de llamada para llamadas de Obsidian (similar a las alertas de GitHub)
Soporte completo de matemáticas LaTeX
Soporte completo de sirena

Errores comunes en las rebajas

Incluso los escritores experimentados cometen estos errores de rebajas. Esto es lo que se debe evitar y cómo.

1. Faltan líneas en blanco alrededor de los elementos del bloque de rebajas

Las listas, encabezados, bloques de código y citas en bloque suelen necesitar una línea en blanco antes y después. Sin él, algunos analizadores los fusionan en el párrafo circundante.

Equivocado:```markdown Here is a paragraph.

Heading

More text.


**Bien:**```markdown
Here is a paragraph.

## Heading

More text.

2. Sangría de lista de rebajas inconsistente

Las listas anidadas necesitan una sangría coherente. Mezclar sangrías de dos y cuatro espacios, o mezclar tabulaciones y espacios, produce resultados impredecibles. Elige uno y quédate con él.

3. Olvidar los espacios finales para los saltos de línea de rebajas

Si desea un salto de línea dentro de un párrafo pero el texto va junto, probablemente olvidó los dos espacios finales. Esta es la pregunta de rebajas más común en Stack Overflow.

4. Las rutas de imagen de rebajas relativas se interrumpen después de la implementación

![logo](images/logo.png) funciona en su editor pero se interrumpe cuando se implementa en un subdirectorio. Utilice rutas absolutas del sitio (/images/logo.png) o URL completas para la portabilidad.

5. Uso de comillas tipográficas al estilo de Word en bloques de código de rebajas

Cuando pega código de un documento que tiene comillas (""en lugar de"`), el código no funcionará cuando se copie. Pegue siempre el código como texto sin formato en los archivos de rebajas.

6. Mezclar HTML y rebajas dentro del mismo bloque

Markdown dentro de las etiquetas HTML a nivel de bloque a menudo no se representa. Esto falla:

<div>
**This bold won't render.**
</div>

Solucionelo separándolas con líneas en blanco o usando HTML en línea únicamente:

<div>

**This bold will render.**

</div>

7. Saltarse los niveles de encabezado de rebajas

Pasar de H1 directamente a H3 reduce el nivel de accesibilidad y perjudica el SEO. Utilice los niveles de título de forma secuencial.

8. Uso de guiones bajos dentro de palabras en rebajas

un_believ_able produce cursiva en algunos analizadores y guiones bajos literales en otros. Utilice asteriscos para enfatizar la mitad de la palabra: "increíble".

Preguntas frecuentes sobre Markdown

¿Para qué se utiliza la rebaja?

Markdown se utiliza para documentación (README, documentos API, wikis), publicaciones de blogs, redacción técnica, toma de notas, mensajes de chat en plataformas como Discord y Slack, sitios web estáticos, libros electrónicos y en cualquier lugar donde el formato de texto sin formato sea útil. La mayoría de los modelos de lenguaje grandes generan respuestas en rebajas de forma predeterminada.

¿El descuento es el mismo en todas las plataformas?

No. La sintaxis básica (encabezados, énfasis, listas, enlaces, código, citas en bloque) funciona en casi todas partes, pero las funciones extendidas como tablas, notas al pie, listas de tareas y matemáticas varían significativamente entre plataformas. Consulte la matriz de compatibilidad anterior para obtener más información.

¿Qué extensión de archivo utiliza Markdown?

.md es el más común. También puede ver .markdown, .mdown, .mkd o .mkdn. Son todos del mismo formato. El tipo MIME es text/markdown, registrado en RFC 7763.

¿Puedo usar HTML dentro de Markdown?

Sí. Casi todos los procesadores de rebajas pasan HTML sin formato a la salida. Así es como la gente agrega características que Markdown no admite de forma nativa, como etiquetas <kbd> para teclas del teclado, <details> para secciones plegables, <iframe> para incrustaciones y más.

¿Cómo convierto Markdown a PDF, Word o HTML?

A HTML: Cada procesador de rebajas hace esto de forma nativa. Pandoc, Markdown-it y Marked son bibliotecas populares.

A PDF: Utilice Pandoc (pandoc input.md -o output.pdf), la función de exportación de Typora o VS Code con la extensión Markdown PDF.

A Word (.docx): Pandoc maneja esto limpiamente con pandoc input.md -o output.docx.

¿Markdown admite ecuaciones matemáticas?

No está en la especificación original, pero muchos procesadores (GitHub, GitLab, Obsidian, MkDocs, Jupyter, Notion) admiten matemáticas LaTeX. Utilice $...$ para matemáticas en línea y $$...$$ para ecuaciones en bloque.

¿En qué se diferencia el Markdown del HTML?

HTML utiliza etiquetas (<p>, <strong>, <a>) que son detalladas pero precisas. Markdown utiliza símbolos de puntuación que se escriben rápidamente y son legibles en formato de texto sin formato. Cada archivo de rebajas se convierte finalmente a HTML para su visualización. Markdown es un superconjunto de HTML. Siempre puedes colocar HTML en un archivo Markdown cuando necesites algo que Markdown no pueda expresar.

¿Qué es CommonMark?

CommonMark es una especificación estandarizada para rebajas, publicada en 2014 para resolver ambigüedades en la especificación original de Gruber. La mayoría de los procesadores implementan CommonMark como base y luego agregan extensiones (tablas, listas de tareas, etc.) encima. GitHub Flavored Markdown es CommonMark más las extensiones de GitHub.

¿Las rebajas son gratuitas?

Sí. Markdown no es software. Es una especificación. Tanto la especificación original de Gruber como la especificación CommonMark están disponibles gratuitamente. El nombre "Markdown" en sí no es una marca registrada.

¿Cuánto tiempo lleva aprender a rebajar?

Los conceptos básicos (títulos, negrita, cursiva, enlaces, listas) tardan unos cinco minutos. Puede escribir rebajas útiles en una hora. Dominar la sintaxis extendida y las variaciones específicas de la plataforma lleva más tiempo, pero esta hoja de referencia cubre casi todo lo que necesitará.

¿Cuál es la diferencia entre rebajas y texto enriquecido?

Los formatos de texto enriquecido (.docx, .rtf) almacenan el formato como datos binarios o XML junto con el texto. Markdown almacena el formato como símbolos visibles de texto sin formato. La desventaja: el texto enriquecido le brinda un control perfecto en píxeles a costa de la portabilidad; Markdown le brinda portabilidad y velocidad a costa de un control detallado.