通用的 HTML 短代码

2023年6月30日 1 分钟阅读短代码文档 HTML

在 Markdown 内容中编写 HTML 的通用 HTML 短代码列表。

本页内容

赞助

短代码和原始 HTML 的区别是什么？

两者区别在于默认情况下，原始 HTML 会被省略，举个例子。

1{{< html/p >}}
2Paragraph written in shortcode.
3{{< /html/p >}}
4
5<p>Paragraph written in raw HTML.</p>

第二个 <p>Paragraph written in raw HTML.</p> 将会被省略，为了避免这种情况，你必须使用短代码或者启用 markup.goldmark.renderer.unsafe。

html/tag 可用于生成任意 HTML 元素，其中 _name 作为元素标签名称，比如 div、p 等等，其余的命名参数将视为元素的属性。

1{{< html/tag _name=[name] [attr]=[val] >}}
2BODY
3{{< /html/tag >}}

类似于 html/tag 短代码，html/void 用于生成空元素，比如 input。

1{{< html/void _name=[name] [attr]=[val] >}}

举个例子。

1{{< html/void
2  _name=input
3  type=password
4  placeholder="Please enter the password"
5  class="form-control mb-3"
6>}}

该模块还内置了一些不需要 _name 参数的、便利的短代码。

1{{< html/tag _name=div class="mb-3 text-center" >}}
2{{< html/void _name=input name=name placeholder=Name >}}
3{{< /html/tag >}}