Syntaxe Markdown pour PDF et Word — couleurs, tableaux, équations

Le Markdown standard fonctionne tel quel. Voici ce que md-to-pdf-word comprend en plus ; le PDF et le Word ont le même rendu.

Informations du document

Tout en haut du fichier (facultatif) :

---
title: Titre du rapport
subtitle: Sous-titre
author: Auteur / équipe
date: today          # remplacé par la date du jour
abstract: Un court résumé.
page-size: A4        # A4 / A5 / B5 / 16K / letter / 17x24cm
number-sections: true
header: none         # pas d’en-tête courant
heading-color: 365F91          # couleur des titres (une par niveau : 365F91,4F81BD)
title-color: 17365D            # title-size: 26
caption-color: 4F81BD          # caption-size: 9  caption-bold: true
---

Sans title, aucun bloc de titre n’est imprimé.

Titres

# niveau 1 … ##### niveau 5. Pour une numérotation automatique, choisissez Numérotation des titres → Numérotés dans « Plus d’options » (les assistants IA utilisent le paramètre number_sections=true) ; n’écrivez alors pas vous-même « 1.1 ».

Styles de texte

Effet	Écrire
Gras / italique / barré	`gras` `italique` `~~barré~~`
Souligné	`[texte]{.underline}` ou `<u>texte</u>`
Double soulignement / ondulé	`[texte]{.double-underline}` / `[texte]{.wave}`
Encadré	`[texte]{.frame}`
Petites capitales	`[Small Caps]{.smallcaps}`
Surligné	`==texte==` ou `[texte]{bg=yellow}`
Couleur	`[texte]{color=red}`, `[texte]{color="#C00000"}`, `[texte]{color=primary}` (couleur du style)
Fond	`[texte]{bg=green}` / `bg="#FFE0B2"`
Taille	`[texte]{size=14pt}`, `size=large`, ou tailles chinoises comme `size=四号`
Police	`[texte]{font=serif}` (serif / sans / mono, ou chinois 宋体 / 黑体 / 楷体 / 仿宋)
Combiné	`[texte]{color=red size=12pt font=sans .bold .underline}`
Exposant / indice	`E=mc^2^`, `H~2~O`
Code en ligne	`code`

Noms de couleurs : red blue green orange purple gray black yellow pink brown cyan teal navy, ou #RRGGBB, rgb(…).
Tailles : 12pt, 16px, 1.2em, ou tailles chinoises 初号小初一号小一二号小二三号小三四号小四五号小五六号.
Les options s’écrivent aussi simplement : underline strike bold italic.
Le HTML fonctionne aussi : <span style="color:#c00;font-size:16px;font-weight:bold">…</span>, <font color="red">, <mark>, <br>.
Les styles imbriqués héritent : [une phrase bleue, [avec un passage rouge plus grand]{color=red size=16pt}, puis bleue]{color=blue}.

Styles de paragraphe

::: {align=center}
Un paragraphe centré (right / left / justify de même)
:::

::: {align=center size=16pt color=primary font=sans}
Un même style pour tout le bloc
:::

<div style="text-align:center">…</div> fonctionne aussi. Une image seule sur sa ligne est centrée automatiquement.

Encadrés

> [!NOTE]
> À noter (aussi TIP / IMPORTANT / WARNING / CAUTION)

::: warning
Un encadré de plusieurs paragraphes.
:::

::: {.tip title="Titre personnalisé"}
Contenu
:::

Tableaux

Tableaux simples | a | b |, alignés avec :--- :---: ---: ; une ligne : Titre du tableau sous le tableau ajoute une légende numérotée.
La ligne d’en-tête est en gras ; les largeurs suivent le contenu et le texte long revient à la ligne dans la page ; les longs tableaux continuent sur les pages suivantes.
Cellules fusionnées : utilisez un tableau HTML :

<table>
  <caption>Titre du tableau</caption>
  <tr><th rowspan="2">Produit</th><th colspan="2">Chiffres</th></tr>
  <tr><th>Chiffre d’affaires</th><th>Bénéfice</th></tr>
  <tr><td>A</td><td>1</td><td>2</td></tr>
</table>

Les tableaux en grille (+---+---+) acceptent aussi les cellules fusionnées. - Les cellules peuvent contenir couleurs, gras, liens et code en ligne.

Images

![Légende (numérotée « Figure N »)](images/chart.png){width=70%}
![](https://example.com/a.jpg){width=50%}

png / jpg / gif / svg / webp / bmp / tiff. Envoyez les images locales avec le document (déposer tout le dossier est le plus simple) ; les images en ligne sont téléchargées automatiquement.
Avec légende → figure numérotée ; sans → image seule. Une image manquante devient un texte gris au lieu de bloquer la conversion.
Une légende déjà numérotée (![Figure 3-1 Architecture](a.png)) garde son numéro.

Sous-figures côte à côte avec étiquettes (a) (b) :

::: {#fig:paire .subfigures}
![Gauche](a.png){width=45%} ![Droite](b.png){width=45%}

Légende commune
:::

Équations

En ligne $E=mc^2$ ou $…$ ; centrées $$…$$ ou \[…\] — toute la notation mathématique standard (matrices, intégrales, sommes…). Dans Word, ce sont des équations modifiables. Des prix comme « $100 et $200 » ne sont pas pris pour des formules.

Notes, citations, listes, code

Notes de bas de page : texte[^1] + [^1]: la note, ou en ligne ^[la note].
Citations : > texte cité.
Listes : - / 1., imbricables ; listes de tâches - [x] ; pas besoin de ligne vide avant une liste.
Blocs de code : ```python ; les lignes longues reviennent à la ligne.

Sauts de page et table des matières

Saut de page : une ligne contenant seulement \newpage, , ou ::: pagebreak + :::.
Table des matières : une ligne [TOC] à l’endroit voulu ; ou cochez Table des matières dans « Plus d’options » (assistants IA : toc=true) pour la placer après le titre.

Mise en page avancée

Pages en paysage : placez les tableaux ou figures larges entre ::: landscape et :::.
Équations numérotées : $$ V=\frac{a}{r} $$ {#eq:rendement} est numérotée (1), (2)… ; [@eq:rendement] dans le texte renvoie à l’équation avec un lien.
Renvois aux tableaux, figures et sections : : Légende {#tbl:nom}, ![Légende](a.png){#fig:nom}, ## Titre {#sec:nom} ; [@tbl:nom] → « Table 1 ».
Bibliographie : ajoutez bibliography: refs.bib aux informations du document (envoyez aussi le .bib) ; citez avec [@cle] ou [@a; @b] → [1], [2,3] ; la liste est générée au format GB/T 7714—2015.
Table des matières partielle : une ligne [本部分目录] sous le titre d’une partie liste seulement ses sections.
Renumérotation des pages : une ligne [页码重置] au début d’une nouvelle partie.
Renvois de page : voir page [@page:sec:nom] → « voir page 5 » ; une cible absente est signalée en rouge.
Annexes : une ligne [附录] commence les annexes ; chaque titre de niveau 1 qui suit devient « Appendix A … » sur une nouvelle page, avec des numéros comme Table A.1, Figure B.1, (A.1).

Page de garde

Ajoutez cover: aux informations du document ; la page de garde est seule et la pagination du corps commence à 1 :

title: Rapport d’évaluation immobilière
cover:
  logo: logo.png                     # facultatif
  number: Rapport n° 2026-0123       # facultatif
  items:                             # facultatif : libellés alignés, valeurs soulignées
    - Client: Banque Exemple
    - Expert: Marie Dupont
  org: Cabinet Exemple
  date: today

cover: true seul crée une page de garde simple à partir de title / subtitle / author / date.

Documents officiels chinois (GB/T 9704)

Un bloc gongwen: active la mise en page des documents officiels (ou choisissez le style « Document officiel ») : zone de texte 156 × 225 mm, Fangsong corps 3, 22 lignes × 28 caractères, numéros de page « — 1 — » à droite sur les pages impaires et à gauche sur les paires. Les clés sont en chinois, comme dans la norme :

title: 关于做好2026年度安全生产工作的通知
gongwen:
  份号: "000123"             # tout est facultatif ; les éléments absents sont omis
  密级: 机密★1年              # classification
  紧急程度: 特急              # urgence
  发文机关标志: 某某市人民政府文件   # en-tête rouge
  发文字号: 某政发〔2026〕12号      # numéro d’émission
  签发人: 张三                # signataire (documents vers une autorité supérieure)
  主送机关: 各区县人民政府，市政府各部门：   # destinataires
  发文机关署名: 某某市人民政府     # autorité émettrice (signature)
  成文日期: 2026-10-24       # date, écrite 2026年10月24日 ; today possible
  印章: 是                   # 是 = avec sceau, 否 = sans sceau
  附注: （此件公开发布）       # note
  抄送: 市委各部门。          # copie à
  印发机关: 某某市人民政府办公室   # imprimé par
  印发日期: 2026-10-24       # date d’impression

Niveaux de titres : # 一、… (Heiti), ## （一）… (Kaiti), ### 1. …, #### （1）… (Fangsong) ; avec la numérotation activée, les numéros sont ajoutés pour vous.
Annexes : entourez chacune de ::: 附件 … ::: ; son premier titre en est l’intitulé. Elles commencent sur une nouvelle page et sont listées après le texte.
Dans Word, un Song gras remplace FZXiaoBiaoSong pour les titres ; si vos lecteurs l’ont installé, ajoutez heading-font: 方正小标宋简体.

Bon à savoir

N’entourez pas tout le document d’un bloc ```markdown (s’il l’est, l’enveloppe est retirée).
Les emoji et symboles rares utilisent des polices de secours dans le PDF ; Word conserve les caractères d’origine.