Sintaxis Markdown para PDF y Word — colores, tablas, ecuaciones

El Markdown estándar funciona tal cual. Esto es lo que md-to-pdf-word entiende además; el PDF y el Word se ven igual.

Información del documento

Al principio del archivo (opcional):

---
title: Título del informe
subtitle: Subtítulo
author: Autor / equipo
date: today          # se sustituye por la fecha de hoy
abstract: Un resumen breve.
page-size: A4        # A4 / A5 / B5 / 16K / letter / 17x24cm
number-sections: true
header: none         # sin encabezado
heading-color: 365F91          # color de títulos (uno por nivel: 365F91,4F81BD)
title-color: 17365D            # title-size: 26
caption-color: 4F81BD          # caption-size: 9  caption-bold: true
---

Sin title no se imprime bloque de título.

Títulos

# nivel 1 … ##### nivel 5. Para numerar automáticamente, en «Más opciones» elige Numeración de títulos → Numerados (los asistentes de IA usan el parámetro number_sections=true); entonces no escribas tú números como «1.1».

Estilos de texto

Efecto	Escritura
Negrita / cursiva / tachado	`negrita` `cursiva` `~~tachado~~`
Subrayado	`[texto]{.underline}` o `<u>texto</u>`
Subrayado doble / ondulado	`[texto]{.double-underline}` / `[texto]{.wave}`
Recuadro	`[texto]{.frame}`
Versalitas	`[Small Caps]{.smallcaps}`
Resaltado	`==texto==` o `[texto]{bg=yellow}`
Color	`[texto]{color=red}`, `[texto]{color="#C00000"}`, `[texto]{color=primary}` (color del estilo)
Fondo	`[texto]{bg=green}` / `bg="#FFE0B2"`
Tamaño	`[texto]{size=14pt}`, `size=large`, o tamaños chinos como `size=四号`
Fuente	`[texto]{font=serif}` (serif / sans / mono, o chinas 宋体 / 黑体 / 楷体 / 仿宋)
Combinado	`[texto]{color=red size=12pt font=sans .bold .underline}`
Superíndice / subíndice	`E=mc^2^`, `H~2~O`
Código en línea	`code`

Nombres de color: red blue green orange purple gray black yellow pink brown cyan teal navy, o #RRGGBB, rgb(…).
Tamaños: 12pt, 16px, 1.2em, o tamaños chinos 初号小初一号小一二号小二三号小三四号小四五号小五六号.
Las opciones se pueden escribir tal cual: underline strike bold italic.
También funciona HTML: <span style="color:#c00;font-size:16px;font-weight:bold">…</span>, <font color="red">, <mark>, <br>.
Los estilos anidados heredan: [una frase azul, [con una parte roja más grande]{color=red size=16pt}, y de nuevo azul]{color=blue}.

Estilos de párrafo

::: {align=center}
Un párrafo centrado (right / left / justify igual)
:::

::: {align=center size=16pt color=primary font=sans}
Un mismo estilo para todo el bloque
:::

<div style="text-align:center">…</div> también funciona. Una imagen sola en su línea se centra automáticamente.

Avisos

> [!NOTE]
> Algo a tener en cuenta (también TIP / IMPORTANT / WARNING / CAUTION)

::: warning
Un aviso con varios párrafos.
:::

::: {.tip title="Título propio"}
Contenido
:::

Tablas

Tablas normales | a | b |, alineadas con :--- :---: ---:; una línea : Título de la tabla debajo añade una leyenda numerada.
La fila de encabezado va en negrita; el ancho de columnas sigue al contenido y el texto largo se ajusta dentro de la página; las tablas largas continúan en las páginas siguientes.
Celdas combinadas: usa una tabla HTML:

<table>
  <caption>Título de la tabla</caption>
  <tr><th rowspan="2">Producto</th><th colspan="2">Cifras</th></tr>
  <tr><th>Ingresos</th><th>Beneficio</th></tr>
  <tr><td>A</td><td>1</td><td>2</td></tr>
</table>

Las tablas en cuadrícula (+---+---+) también admiten celdas combinadas. - Las celdas pueden llevar colores, negrita, enlaces y código en línea.

Imágenes

![Leyenda (numerada como «Figure N»)](images/chart.png){width=70%}
![](https://example.com/a.jpg){width=50%}

png / jpg / gif / svg / webp / bmp / tiff. Sube las imágenes locales junto con el documento (arrastrar la carpeta entera es lo más fácil); las imágenes web se descargan solas.
Con leyenda → figura numerada; sin ella → solo la imagen. Una imagen que falta se convierte en texto gris en lugar de detener la conversión.
Una leyenda ya numerada (![Figura 3-1 Arquitectura](a.png)) conserva su número.

Subfiguras lado a lado con (a) (b):

::: {#fig:par .subfigures}
![Izquierda](a.png){width=45%} ![Derecha](b.png){width=45%}

Leyenda común
:::

Ecuaciones

En línea $E=mc^2$ o $…$; destacadas $$…$$ o \[…\], con toda la notación matemática habitual (matrices, integrales, sumatorios…). En Word son ecuaciones editables. Precios como «$100 y $200» no se confunden con fórmulas.

Notas, citas, listas, código

Notas al pie: texto[^1] + [^1]: la nota, o en línea ^[la nota].
Citas: > texto citado.
Listas: - / 1., anidables; listas de tareas - [x]; no hace falta línea en blanco antes.
Bloques de código: ```python; las líneas largas se ajustan.

Saltos de página e índice

Salto de página: una línea solo con \newpage, , o ::: pagebreak + :::.
Índice: una línea [TOC] donde lo quieras; o marca Índice en «Más opciones» (asistentes de IA: toc=true) para ponerlo tras el título.

Maquetación avanzada

Páginas apaisadas: pon tablas o figuras anchas entre ::: landscape y :::.
Ecuaciones numeradas: $$ V=\frac{a}{r} $$ {#eq:rendimiento} se numera (1), (2)…; [@eq:rendimiento] en el texto la referencia con un enlace.
Referencias a tablas, figuras y secciones: : Leyenda {#tbl:nombre}, ![Leyenda](a.png){#fig:nombre}, ## Título {#sec:nombre}; [@tbl:nombre] → «Table 1».
Bibliografía: añade bibliography: refs.bib a la información del documento (sube también el .bib); cita con [@clave] o [@a; @b] → [1], [2,3]; la lista se genera en estilo GB/T 7714—2015.
Índice parcial: una línea [本部分目录] bajo el título de una parte lista solo sus secciones.
Reiniciar la numeración de páginas: una línea [页码重置] al empezar una parte nueva.
Referencias de página: véase la página [@page:sec:nombre] → «véase la página 5»; un destino inexistente se marca en rojo y se avisa.
Apéndices: una línea [附录] inicia los apéndices; cada título de nivel 1 posterior se convierte en «Appendix A …» en página nueva, con números como Table A.1, Figure B.1, (A.1).

Portada

Añade cover: a la información del documento; la portada va en su propia página y la numeración del cuerpo empieza en 1:

title: Informe de tasación inmobiliaria
cover:
  logo: logo.png                     # opcional
  number: Informe n.º 2026-0123      # opcional
  items:                             # opcional: etiquetas alineadas, valores subrayados
    - Cliente: Banco Ejemplo
    - Tasadora: Ana García
  org: Tasaciones Ejemplo S.L.
  date: today

cover: true por sí solo crea una portada sencilla con title / subtitle / author / date.

Documentos oficiales chinos (GB/T 9704)

Un bloque gongwen: activa la maquetación de documento oficial (o elige el estilo «Documento oficial»): caja de texto de 156 × 225 mm, Fangsong de cuerpo 3, 22 líneas × 28 caracteres, números de página «— 1 —» a la derecha en impares y a la izquierda en pares. Las claves van en chino, como en la norma:

title: 关于做好2026年度安全生产工作的通知
gongwen:
  份号: "000123"             # todo opcional; los elementos ausentes se omiten
  密级: 机密★1年              # clasificación
  紧急程度: 特急              # urgencia
  发文机关标志: 某某市人民政府文件   # encabezado rojo
  发文字号: 某政发〔2026〕12号      # número de emisión
  签发人: 张三                # firmante (documentos a un órgano superior)
  主送机关: 各区县人民政府，市政府各部门：   # destinatarios
  发文机关署名: 某某市人民政府     # autoridad emisora (firma)
  成文日期: 2026-10-24       # fecha, escrita 2026年10月24日; today sirve
  印章: 是                   # 是 = con sello, 否 = sin sello
  附注: （此件公开发布）       # nota
  抄送: 市委各部门。          # copia a
  印发机关: 某某市人民政府办公室   # impreso por
  印发日期: 2026-10-24       # fecha de impresión

Niveles de título: # 一、… (Heiti), ## （一）… (Kaiti), ### 1. …, #### （1）… (Fangsong); con la numeración activada, los números se añaden solos.
Anexos: envuelve cada uno en ::: 附件 … :::; su primer título es el nombre del anexo. Empiezan en página nueva y se listan tras el texto.
En Word, una Song en negrita sustituye a FZXiaoBiaoSong en los títulos; si tus lectores la tienen instalada, añade heading-font: 方正小标宋简体.

Conviene saber

No envuelvas todo el documento en un bloque ```markdown (si lo haces, se quita el envoltorio).
Los emoji y símbolos poco comunes usan fuentes alternativas en el PDF; Word conserva los caracteres originales.