記法ガイド

標準の Markdown はそのまま使えます。以下は md-to-pdf-word が追加で理解する記法です。PDF と Word の仕上がりは同じです。

文書情報

ファイルの先頭に書きます（省略可）：

---
title: 報告書のタイトル
subtitle: サブタイトル
author: 著者 / チーム
date: 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 がなければタイトル部分は作られません。

見出し

# が第 1 階層 … ##### が第 5 階層。自動で番号を付けるには、「その他のオプション」で 見出し番号 → 番号を付ける を選びます（AI アシスタントはパラメーター number_sections=true）。その場合「1.1」などを自分で書かないでください。

文字の書式

• 色の名前：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=16pt color=primary font=sans}
ブロック全体を同じ書式に
:::

<div style="text-align:center">…</div> も使えます。1 行に画像だけを置くと自動で中央揃えになります。

注意ボックス

> [!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>

グリッド表（+---+---+）でもセルを結合できます。 - セルの中で色、太字、リンク、インラインコードが使えます。

画像

![キャプション（「Figure N」と番号が付きます）](images/chart.png){width=70%}
![](https://example.com/a.jpg){width=50%}

• png / jpg / gif / svg / webp / bmp / tiff。手元の画像は文書と一緒にアップロードしてください（フォルダごとドロップするのが簡単）。Web 上の画像は自動で取得します。

• キャプションあり → 番号付きの図、なし → 画像だけ。見つからない画像は灰色の代わりのテキストになり、変換は止まりません。

• 番号付きのキャプション（![図3-1 構成](a.png)）はその番号を保ちます。

• 横並びのサブ図（(a)(b) 付き）：

  ::: {#fig:組 .subfigures}
  ![左](a.png){width=45%} ![右](b.png){width=45%}
  
  2 つの図の共通キャプション
  :::

数式

インラインは $E=mc^2$ または \(…\)、別行立ては $$…$$ または \[…\]。行列・積分・総和など、一般的な数式記法がすべて使えます。Word では編集できる数式になります。「$100 と $200」のような金額は数式と誤認されません。

脚注・引用・リスト・コード

• 脚注：本文[^1] ＋ [^1]: 脚注の内容、またはインラインの ^[脚注の内容]。
• 引用：> 引用文。
• リスト：- / 1.、入れ子可。タスクリスト - [x]。リストの前に空行は不要です。
• コードブロック：```python。長い行は折り返します。

改ページと目次

• 改ページ：1 行に \newpage、<!-- pagebreak -->、または ::: pagebreak ＋ ::: だけを書きます。
• 目次：入れたい位置に [TOC] だけの行を書くか、「その他のオプション」で 目次を作成 にチェック（AI アシスタントは toc=true）するとタイトルの後に入ります。

高度なレイアウト

• 横向きページ：広い表や図を ::: landscape と ::: で囲みます。
• 数式番号：$$ V=\frac{a}{r} $$ {#eq:利回り} は (1)、(2)… と番号が付き、本文の [@eq:利回り] からリンクで参照できます。
• 表・図・節の参照：: キャプション {#tbl:名前}、![キャプション](a.png){#fig:名前}、## 見出し {#sec:名前}。[@tbl:名前] → 表の番号。
• 参考文献：文書情報に bibliography: refs.bib と書き（.bib も一緒にアップロード）、[@キー] や [@a; @b] で引用 → [1]、[2,3]。参考文献リストは GB/T 7714—2015 形式で作られます。
• 部ごとの目次：部の見出しの下に [本部分目录] の行を書くと、その部の節だけを一覧にします。
• ページ番号のリセット：新しい部の始まりに [页码重置] の行を書きます。
• ページ参照：[@page:sec:名前] でそのページ番号を表示します。参照先がない場合は赤字で示し、お知らせします。
• 付録：[附录] の行から付録が始まり、以降の第 1 階層の見出しはそれぞれ新しいページの付録 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 号の仿宋、1 ページ 22 行 × 1 行 28 字、ページ番号「— 1 —」は奇数ページで右、偶数ページで左。キーは規格どおり中国語です：

title: 关于做好2026年度安全生产工作的通知
gongwen:
  份号: "000123"             # すべて省略可。書かない要素は配置されません
  密级: 机密★1年              # 秘密区分
  紧急程度: 特急              # 緊急度
  发文机关标志: 某某市人民政府文件   # 赤い発行機関名
  发文字号: 某政发〔2026〕12号      # 文書番号
  签发人: 张三                # 署名者（上級機関あて）
  主送机关: 各区县人民政府，市政府各部门：   # 宛先
  发文机关署名: 某某市人民政府     # 発行機関の署名
  成文日期: 2026-10-24       # 日付（2026年10月24日 と表記）。today も可
  印章: 是                   # 是 = 押印あり、否 = 押印なし
  附注: （此件公开发布）       # 附注
  抄送: 市委各部门。          # 写しの送付先
  印发机关: 某某市人民政府办公室   # 印刷発行機関
  印发日期: 2026-10-24       # 印刷発行日

• 見出しの階層：# 一、…（黒体）、## （一）…（楷体）、### 1. …、#### （1）…（仿宋）。見出し番号を有効にすると番号は自動で付きます。
• 添付：それぞれ ::: 附件 … ::: で囲み、中の最初の見出しが添付の名称です。新しいページから始まり、本文の後に一覧が入ります。
• Word ではタイトルの方正小標宋の代わりに太字の宋体を使います。読む人の環境に入っている場合は heading-font: 方正小标宋简体 を書いてください。

知っておくと便利

• 文書全体を ```markdown のコードブロックで囲まないでください（囲んでも自動で外されます）。
• 絵文字や珍しい記号は、PDF では代替フォントで表示し、Word では元の文字のままです。