# transform.HTMLToMarkdown
> 返回转换为 Markdown 后的给定 HTML。
- 官方英文原文：https://gohugo.io/functions/transform/htmltomarkdown/
- 本页规范地址：https://hugozh.cn/functions/transform/htmltomarkdown/
- 最近更新：2026-10-02
- 最后提交：912b1d3 chore(site): 添加 static/CNAME（hugozh.cn），供 GitHub Pages 等平台绑定自定义域名
- 签名：transform.HTMLToMarkdown INPUT
- 返回类型：string
- 站点：Hugo 中文文档（https://hugozh.cn/）· 社区维护的非官方中文翻译，如有出入以官方英文原文为准

---
（0.151.0 新增）

> [!NOTE]
> 该函数是实验性的，其 API 将来可能变化。

`transform.HTMLToMarkdown` 函数借助 [`html-to-markdown`][] Go 包把 HTML 转换为 Markdown。

## 用法

```go-html-template
{{ .Content | transform.HTMLToMarkdown | safeHTML }}
```

## 插件

转换过程由以下 `html-to-markdown` 插件实现：

插件|说明
:--|:--
Base|实现基本的共享功能
CommonMark|按 [CommonMark][] 规范实现 Markdown
Table|按 [GitHub 风格 Markdown][] 规范实现表格

[CommonMark]: https://spec.commonmark.org/current/
[GitHub 风格 Markdown]: https://github.github.com/gfm/
[`html-to-markdown`]: https://github.com/JohannesKaufmann/html-to-markdown?tab=readme-ov-file#readme