pandoc ：Markdown 转换 word，典型用法 （**）

除了主要部分，各种 md 工具的语法都相同之外；扩展部分，则各有各的不同。

markdown 目前（2023）还处在战国时代，没有统一的语法规范。

要么专门在一种、或一套 md 开发工具链上使用？要么只使用它们的公共部分？

而公共部分，似乎只有很少的要素，如、“标题”，才是公共的。

md 似乎不适用于需要经常修改的场景？经常修改，意味着需要经常替换，md 的段落格式导致一句话会被割裂？<< 是否如此？

word 的有些应用场景，目前是 md 无法取代的？md 适合于在网络上的展示？

Pandoc 官方 demos 示例 ：https://pandoc.org/demos.html

Pandoc User’s Guide ：https://pandoc.org/MANUAL.html

Markdown 转换 word

  https://www.nw52.com/soft/app/2953.html

用法实例

markdown转docx

pandoc demo-math.md -o demo-math.docx

将名为demo-math.md的文件转化为demo-math.docx的word文档。

markdown转Html

pandoc -f markdown -t html5 input.md -o output.html

转docx并指定样式

pandoc -s m.md -S --reference-docx reference.docx -o m.docx

将名为m.md的文件转化为m.docx的word文档，同时使用reference.docx中的样式作为模板，这在一定程度上实现了word创作时的内容和表现分离。

注意：上面的示例，应该是旧版本的吧？

pandoc 3.1.9

是 --reference-doc，不是--reference-docx

$ pandoc -s m.md --reference-doc custom-reference.docx -o m.docx

word转md

pandoc -f docx -t markdown --extract-media ./images -o aaa.md aaa.docx

以上的语法格式为将一篇 word 文档转换为 markdown 格式，有图片的话生成的图片在.\images\media 这个文件夹目录下。

官方手册：摘要

  https://pandoc.org/MANUAL.html

General options

-h, --help

-f FORMAT, -r FORMAT, --from=FORMAT, --read=FORMAT

-t FORMAT, -w FORMAT, --to=FORMAT, --write=FORMAT

-o FILE, --output=FILE

--list-input-formats

--list-output-formats

-F PROGRAM, --filter=PROGRAM

--metadata-file=FILE

--extract-media=DIR

General writer options

-s, --standalone

--template=FILE|URL

--toc[=true|false], --table-of-contents[=true|false]

--toc-depth=NUMBER

Options affecting specific writers

--self-contained[=true|false]

--reference-doc=FILE|URL

--pdf-engine=PROGRAM

--pdf-engine-opt=STRING

导出官方当前版本的 reference.docx，可以知道到底能够支持到 docx 的哪些标签？

To produce a custom reference.docx, first get a copy of the default reference.docx:

pandoc -o custom-reference.docx --print-default-data-file reference.docx

Then open custom-reference.docx in Word, modify the styles as you wish, and save the file. For best results, do not make changes to this file other than modifying the styles used by pandoc:

pandoc -s m.md --reference-doc custom-reference.docx -o m.docx

官方给出示例：  https://pandoc.or