Hugo框架中能否在HTML文件中引入Markdown文件？

方法1：直接用模板函数读取并渲染 #

在你的index.html模板中添加以下代码，即可读取content.md并将其转换为HTML注入页面：

{{ readFile "content.md" | markdownify }}

• 若content.md存放在项目的content子目录下，路径需改为"content/content.md"
• readFile负责读取文件内容，markdownify会将Markdown语法转换为对应的HTML标签

方法2：自定义短代码（适合多页面复用） #

如果需要在多个页面重复注入Markdown内容，可创建自定义短代码：

1. 在项目的layouts/shortcodes/目录下新建inject-md.html文件
2. 写入以下内容：

{{ readFile (.Get "path") | markdownify }}

3. 在index.html中调用该短代码：

{{< inject-md path="content.md" >}}

常见问题排查 #

• 提示"file not found"：检查文件路径是否正确，Hugo路径区分大小写，需确保文件名和路径拼写完全匹配
• Markdown未转成HTML：确认代码中包含markdownify函数，缺失的话只会输出原始文本
• 样式异常：若Markdown内有自定义样式，需确保HTML页面的CSS规则能兼容或覆盖这些样式

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