Markdown 写作语法：颜色、表格、公式、公文（PDF 与 Word）| md-to-pdf-word

标准 Markdown 直接可用。下面是 md-to-pdf-word 额外支持的写法，PDF 和 Word 两种输出效果一致。

文档信息

写在文件最开头（可选）：

---
title: 报告标题
subtitle: 副标题
author: 作者 / 团队
date: today          # today 会自动换成当天日期
abstract: 一段摘要。
page-size: A4        # A4 / A5 / B5 / 16K / letter / 17x24cm
number-sections: true
header: none         # 不要页眉
heading-color: 365F91          # 标题颜色（可按级别写多个：365F91,4F81BD）
title-color: 17365D            # title-size: 26
caption-color: 4F81BD          # caption-size: 9  caption-bold: true
---

没有 title 时不生成标题区。

标题层级

# 一级 … ##### 五级。需要自动编号时，在“更多选项”里把“标题编号”设为“自动编号”（AI 助手用参数 number_sections=true），此时标题里不要再手写“一、”“1.1”。

文字样式

效果	写法
粗体 / 斜体 / 删除线	`粗体` `斜体` `~~删除~~`
下划线	`[文字]{.underline}` 或 `<u>文字</u>`
双下划线 / 波浪线	`[文字]{.double-underline}` / `[文字]{.wave}`
加框	`[文字]{.frame}`
小型大写	`[Small Caps]{.smallcaps}`
高亮	`==文字==` 或 `[文字]{bg=yellow}`
颜色	`[文字]{color=red}`、`[文字]{color="#C00000"}`、`[文字]{color=primary}`（主题色）
背景色	`[文字]{bg=green}` / `bg="#FFE0B2"`
字号	`[文字]{size=四号}`、`size=14pt`、`size=large`
字体	`[文字]{font=楷体}`（宋体 / 黑体 / 楷体 / 仿宋 / 微软雅黑 / mono）
组合	`[文字]{color=red size=小四 font=黑体 .bold .underline}`
上标 / 下标	`E=mc^2^`、`H~2~O`
行内代码	`code`

颜色名：red blue green orange purple gray black yellow pink brown cyan teal navy，或中文“红色、蓝色…”，或 #RRGGBB、rgb(…)。
中文字号：初号小初一号小一二号小二三号小三四号小四五号小五六号；也可写 12pt、16px、1.2em。
开关类属性可以直接写：underline strike bold italic。
HTML 写法同样有效：<span style="color:#c00;font-size:16px;font-weight:bold">…</span>、<font color="red">、<mark>、<br>。
嵌套时内层继承外层：[蓝色整句，[其中红色放大]{color=red size=16pt}，后面恢复]{color=blue}。

段落样式

::: {align=center}
居中的段落（right / left / justify 同理）
:::

::: {align=center size=三号 color=primary font=黑体}
整块统一样式
:::

<div style="text-align:center">…</div> 也有效。单独成段的图片自动居中。

提示框

> [!NOTE]
> 注意事项（还有 TIP / IMPORTANT / WARNING / CAUTION）

::: warning
可以写多段的提示框。
:::

::: {.tip title="自定义标题"}
内容
:::

表格

普通表格 | a | b |，对齐用 :--- :---: ---:；表格下一行写 : 表格标题 生成带编号的表题。
表头自动加粗；长文本按内容分配列宽并换行，不会超出页面；长表格自动跨页。
合并单元格用 HTML 表格：

<table>
  <caption>表题</caption>
  <tr><th rowspan="2">产品</th><th colspan="2">指标</th></tr>
  <tr><th>收入</th><th>利润</th></tr>
  <tr><td>A</td><td>1</td><td>2</td></tr>
</table>

也可以用网格表（+---+---+ 写法，同样支持跨行跨列）。 - 单元格里可以用颜色、粗体、链接、行内代码。

图片

![图题（会生成“图 N”编号）](images/chart.png){width=70%}
![](https://example.com/a.jpg){width=50%}

支持 png / jpg / gif / svg / webp / bmp / tiff；本地图片请和文档一起上传（拖入整个文件夹最省事），网络图片自动下载。
有图题 → 带编号；没有 → 只放图片。找不到的图片变成灰色占位文字，不会导致转换失败。
图题已带编号（![图3-1 架构](a.png)）时保留原编号。

子图（并排，带 (a)(b) 小题）：

::: {#fig:组合 .subfigures}
![子图甲](a.png){width=45%} ![子图乙](b.png){width=45%}

两张图的总图题
:::

公式

行内 $E=mc^2$ 或 $…$；独立公式 $$…$$ 或 \[…\]，支持完整的数学公式写法（矩阵、积分、求和等）。Word 中是可编辑的公式。金额写法“$100 和 $200”不会被误认成公式。

脚注、引用、列表、代码

脚注：正文[^1] + [^1]: 脚注内容，或行内 ^[脚注内容]。
引用：> 引用文字。
列表：- / 1.，可嵌套；任务列表 - [x]；列表前不必空行。
代码块：```python，长行自动折行。

分页与目录

分页：单独一行写 \newpage、，或 ::: pagebreak + :::。
目录：在需要的位置单独一行写 [TOC]；也可以在“更多选项”里勾选“生成目录”（AI 助手用 toc=true），目录放在标题之后。

高级排版

横向页面：宽表、大图包在 ::: landscape 和 ::: 之间，这部分横排，之后恢复纵向。
公式编号：$$ V=\frac{a}{r} $$ {#eq:收益} 自动编号 (1)(2)…；正文写 [@eq:收益] 显示“式(1)”并可跳转。
表、图、章节引用：表题 : 表题 {#tbl:名}、图 ![图题](a.png){#fig:名}、标题 ## 标题 {#sec:名}；引用 [@tbl:名] → “表 1”。
参考文献：文档信息里写 bibliography: refs.bib（.bib 一起上传）；正文 [@文献键] 或 [@a; @b] → 上标 [1]、[2,3]；文末按 GB/T 7714—2015 自动生成“参考文献”。
分部目录：某部分标题下单独一行 [本部分目录]，只列该部分的章节。
页码重置：新部分开始处单独一行 [页码重置]，页码从 1 起。
页码引用：见第[@page:sec:名]页 → “见第 5 页”；目标不存在会标红并提示。
附录：附录开始处单独一行 [附录]，其后每个一级标题自动成为“附录A …”“附录B …”并另页起；附录内编号为“表 A.1”“图 B.1”“式 (A.1)”。

封面

文档信息里加 cover:，封面独立成页，正文页码从 1 起：

title: 房地产抵押估价报告
cover:
  logo: logo.png                     # 可选
  number: 某某估字〔2026〕第0123号     # 可选
  items:                             # 可选：标签两端对齐、值带下划线
    - 估价委托人: 某某银行
    - 注册房地产估价师: 张三
  org: 某某房地产土地评估有限公司
  date: today

只写 cover: true 时，用 title / subtitle / author / date 生成简式封面。

党政机关公文（GB/T 9704）

文档信息里加 gongwen: 即自动使用公文版式（也可以选“党政公文”风格）：版心 156×225 mm，3 号仿宋，每页 22 行、每行 28 字；“— 1 —”页码单页居右、双页居左。

title: 关于做好2026年度安全生产工作的通知
gongwen:
  份号: "000123"             # 以下均可选，没有的要素不排
  密级: 机密★1年
  紧急程度: 特急
  发文机关标志: 某某市人民政府文件
  发文字号: 某政发〔2026〕12号
  签发人: 张三                # 上行文：发文字号居左、签发人居右
  主送机关: 各区县人民政府，市政府各部门：
  发文机关署名: 某某市人民政府
  成文日期: 2026-10-24       # 自动写成 2026年10月24日；可写 today
  印章: 是                   # 是 = 加盖印章版式；否 = 不加盖印章版式
  附注: （此件公开发布）
  抄送: 市委各部门，市人大常委会办公室。
  印发机关: 某某市人民政府办公室
  印发日期: 2026-10-24

正文层次：# 一、…（黑体）、## （一）…（楷体）、### 1. …、#### （1）…（仿宋）。开启标题编号时自动加“一、（一）1.（1）”。
附件：每个附件写成 ::: 附件 … :::，块内第一个标题是附件名称；自动另面编排并在正文后列出附件说明。
Word 中标题和红头用“宋体加粗”代替方正小标宋；确定对方已安装时，可写 heading-font: 方正小标宋简体。

注意事项

不要把整篇文档包在 ```markdown 代码块里（包了也会被自动去掉）。
Emoji 和生僻符号在 PDF 中自动换用备用字体；Word 保留原字符。