如何使用Pandoc将Markdown转HTML时自定义文档标题？

你的问题核心是Pandoc默认输出的是HTML片段，而非完整的HTML文档，所以直接用--metadata设置title不会生成<head>和<title>标签，因为片段模式下Pandoc不会构建完整的页面结构。

方法一：生成完整HTML文档（推荐） #

使用--standalone（简写-s）参数让Pandoc生成完整的HTML文档，配合--metadata指定自定义标题：

pandoc --from markdown --to html -s --metadata title="Custom title" input.md -o output.html

执行后生成的output.html会包含完整的页面结构，其中<head>部分会正确生成<title>Custom title</title>，且不会自动添加额外后缀或多余样式（默认模板的基础样式可保留，若不需要可后续调整）。

方法二：自定义极简模板 #

如果想要完全控制HTML结构，可创建一个自定义模板文件（比如simple-template.html）：

<!DOCTYPE html>
<html>
<head>
  <title>$title$</title>
</head>
<body>
$body$
</body>
</html>

然后用以下命令调用模板：

pandoc --from markdown --to html --template=simple-template.html --metadata title="Custom title" input.md -o output.html

这种方式可以生成完全符合你需求的极简HTML结构，仅包含指定的<head>和内容部分。

为什么之前的方法失败？ #

你之前的命令没有添加--standalone参数，Pandoc默认输出HTML片段（只包含内容对应的标签，比如<h1>、<p>），此时--metadata中的title不会被用来构建<head>结构，只有在完整文档模式下才会解析metadata并生成页面头部。

而--title选项本质是触发完整文档模式，但它会自动将文件名作为标题后缀（比如Custom title – input），这不符合你的需求，因此用--metadata title配合--standalone是更精准的方案。

内容的提问来源于stack exchange，提问作者Unideal