1. Gramática básica de Markdown
1. Sintaxis del título
Para crear un título, preceda una palabra o frase con un signo de almohadilla (#). El número de # representa el nivel del título. Por ejemplo, agregar tres # crea un encabezado de tercer nivel (<h3>) (por ejemplo: ### Mi encabezado).
| Sintaxis de rebajas | HTML | efecto de vista previa |
|---|---|---|
| # Encabezado nivel 1 | <h1>Título de nivel 1</h1> | Encabezado nivel 1 |
| ## Encabezado nivel 2 | <h2>Nivel de título 2</h2> | Encabezado nivel 2 |
| ### Encabezado nivel 3 | <h3>Título nivel 3</h3> | Encabezado nivel 3 |
| #### Encabezado nivel 4 | <h4>Nivel de encabezado 4</h4> | Encabezado nivel 4 |
| ##### Encabezado nivel 5 | <h5>Nivel de encabezado 5</h5> | Encabezado nivel 5 |
| ###### Encabezado nivel 6 | <h6>Encabezado nivel 6</h6> | Encabezado nivel 6 |
1.1 Sintaxis opcional
También puede agregar cualquier número de signos == debajo del texto para identificar encabezados de primer nivel, o signos – para identificar encabezados de segundo nivel.
| Sintaxis de rebajas | HTML | efecto de vista previa |
|---|---|---|
| Nivel de título 1 ============ |
<h1>Título de nivel 1</h1> | Encabezado nivel 1 |
| Encabezado nivel 2 --------------------- |
<h2>Nivel de título 2</h2> | Encabezado nivel 2 |
1.2 Mejores prácticas
Diferentes aplicaciones de Markdown manejan el espacio entre # y encabezados de manera inconsistente. Para compatibilidad, separe # y el título con un espacio.
| ✅ Haz esto | ❌ No hagas esto |
|---|---|
| # Aquí hay un encabezado | #Aquí hay un encabezado |
2. Gramática del párrafo
2.1 Mejores prácticas
3. Sintaxis de nueva línea
3.1 Mejores prácticas
4. Énfasis en la gramática
Enfatice la importancia del texto poniéndolo en negrita o cursiva.
4.1 Negrita
Al texto en negrita, agregue dos asteriscos (asteriscos) o guiones bajos (guiones bajos) antes y después de una palabra o frase. Para poner en negrita el medio de una palabra o frase para enfatizar, agregue dos asteriscos (asteriscos) a cada lado de la parte en negrita.
| Sintaxis de rebajas | HTML | efecto de vista previa |
|---|---|---|
| Me encanta **texto en negrita**. | Me encanta el <strong>texto en negrita</strong>. | Me encanta el texto en negrita . |
| Me encanta _texto en negrita_ . | Me encanta el <strong>texto en negrita</strong>. | Me encanta el texto en negrita . |
| El amor ** es ** audaz | El amor<strong>es</strong>audaz | El amor es audaz |
4.1.1 Mejores prácticas
Las aplicaciones de Markdown no son consistentes en cómo manejar los guiones bajos en medio de palabras o frases. Para compatibilidad, use asteriscos cuando esté en negrita en medio de una palabra o frase.
| ✅ Haz esto | ❌ No hagas esto |
|---|---|
| El amor ** es ** audaz | El amor__es__audaz |
4.2 Cursiva
Para poner texto en cursiva, agregue un asterisco (asterisco) o un guión bajo (guion bajo) antes o después de una palabra o frase. Para poner en cursiva la mitad de una palabra, agregue un asterisco antes y después de la letra, sin espacios en el medio.
4.2.1 Mejores prácticas
Para resaltar texto tanto en negrita como en cursiva, agregue tres asteriscos o subrayados antes y después de una palabra o frase. Para poner en negrita y cursiva el medio de una palabra o frase, agregue tres asteriscos antes y después de la parte que desea resaltar, sin espacios entre ellos.
| ✅ Haz esto | ❌ No hagas esto |
|---|---|
| Un*gato*miau | A_gato_maullido |
4.3 Negrita y cursiva
Para resaltar texto tanto en negrita como en cursiva, agregue tres asteriscos o subrayados antes y después de una palabra o frase. Para poner en negrita y cursiva el medio de una palabra o frase, agregue tres asteriscos antes y después de la parte que desea resaltar, sin espacios entre ellos.
4.3.1 Mejores prácticas
| ✅ Haz esto | ❌ No hagas esto |
|---|---|
| This is really***very***important text. | This is really___very___important text. |
5、引用语法
要创建块引用，请在段落前添加一个 > 符号。
> Dorothy followed her through many of the beautiful rooms in her castle.
渲染效果如下所示：
Dorothy followed her through many of the beautiful rooms in her castle.
5.1 多个段落的块引用
块引用可以包含多个段落。为段落之间的空白行添加一个 > 符号。
> Dorothy followed her through many of the beautiful rooms in her castle.
>
> The Witch bade her clean the pots and kettles and sweep the floor and keep the fire fed with wood.
渲染效果如下：
Dorothy followed her through many of the beautiful rooms in her castle.
The Witch bade her clean the pots and kettles and sweep the floor and keep the fire fed with wood.
5.2 嵌套块引用
块引用可以嵌套。在要嵌套的段落前添加一个 >> 符号。
> Dorothy followed her through many of the beautiful rooms in her castle.
>
>> The Witch bade her clean the pots and kettles and sweep the floor and keep the fire fed with wood.
渲染效果如下：
Dorothy followed her through many of the beautiful rooms in her castle.
The Witch bade her clean the pots and kettles and sweep the floor and keep the fire fed with wood.
5.3 带有其它元素的块引用
块引用可以包含其他 Markdown 格式的元素。并非所有元素都可以使用，你需要进行实验以查看哪些元素有效。
> #### The quarterly results look great!
>
> - Revenue was off the chart.
> - Profits were higher than ever.
>
> *Everything* is going according to **plan**.
渲染效果如下：
The quarterly results look great!
- Revenue was off the chart.
- Profits were higher than ever.
Everything is going according to plan.
6、列表语法
可以将多个条目组织成有序或无序列表。
6.1有序列表
要创建有序列表，请在每个列表项前添加数字并紧跟一个英文句点。数字不必按数学顺序排列，但是列表应当以数字 1 起始。
6.1.1 有序列表最佳实践
CommonMark y algunos otros lenguajes de marcado livianos le permiten usar un paréntesis ()) como delimitador (por ejemplo, 1) Primer elemento), pero no todas las aplicaciones de Markdown lo admiten, por lo que no es una gran opción desde una perspectiva de compatibilidad. Para compatibilidad, use períodos solamente.
| ✅ Haz esto | ❌ No hagas esto |
|---|---|
| 1. Primer elemento 2. Segundo elemento |
1) Primer elemento 2) Segundo elemento |
6.2 Listas desordenadas
Para crear una lista desordenada, preceda cada elemento de la lista con un guión (-), un asterisco (*) o un signo más (+). Sangrar uno o más elementos de la lista crea listas anidadas.
Tutorial oficial de Markdown: https://markdown.com.cn/