# RenderString
> 把给定的标记语言渲染为 HTML 并返回。
- 官方英文原文：https://gohugo.io/methods/page/renderstring/
- 本页规范地址：https://hugozh.cn/methods/page/renderstring/
- 最近更新：2026-10-02
- 最后提交：912b1d3 chore(site): 添加 static/CNAME（hugozh.cn），供 GitHub Pages 等平台绑定自定义域名
- 签名：PAGE.RenderString [OPTIONS] MARKUP
- 返回类型：template.HTML
- 站点：Hugo 中文文档（https://hugozh.cn/）· 社区维护的非官方中文翻译，如有出入以官方英文原文为准

---
`Page` 对象上的 `RenderString` 方法会把标记语言渲染为 HTML。

```go-html-template
{{ $s := "An *emphasized* word" }}
{{ $s | .RenderString }} → An <em>emphasized</em> word
```

## 选项

`Page` 对象上的 `RenderString` 方法接受一个选项映射。

`display`
: （`string`）指定 `inline` 或 `block`。若为 `inline`，会移除短片段外围的 `p` 标签。默认为 `inline`。

`markup`
: （`string`）为所提供的标记语言指定一个[标记语言标识符][]。默认取前置元数据中的 `markup` 值，若没有则回退到根据页面文件扩展名推导出的值。

## 示例

以块级显示模式把 Markdown 内容渲染为 HTML：

```go-html-template
{{ $opts := dict "display" "block" }}
{{ $s | .RenderString $opts }} → <p>An <em>emphasized</em> word</p>
```

以块级显示模式把 [Pandoc][] 内容渲染为 HTML：

```go-html-template
{{ $s := "H~2~O" }}

{{ $opts := dict "markup" "pandoc" "display" "block" }}
{{ $s | .RenderString $opts }} → H<sub>2</sub>O
```

[Pandoc]: /content-management/formats/#pandoc
[markup identifier]: /content-management/formats/#classification