下面介绍的不是 Markdown 的标准语法,一些属于 idoc 自定义的语法,还有一些属于 Github GFM
中的一些语法。
我们使用 <!--idoc:ignore:start-->
与 <!--idoc:ignore:end-->
这个注释语法,忽略被包裹在中间的内容,这很有用,在 GitHub 中预览 Markdown 注释会被忽略,在编译后的 HTML 中,忽略被包裹的 Markdown 内容:
<!--idoc:ignore:start-->
idoc
===
<!--idoc:ignore:end-->
通过使用 HTML 注释 <!--rehype:xxx-->
,解锁 Markdown 语法解析自生的一些限制,比如设置颜色,定义一个链接地址在新窗口中打开等。
## Title
<!--rehype:style=display: flex; height: 230px; align-items: center; justify-content: center; font-size: 38px;-->
Markdown Supports **Style**<!--rehype:style=color: red;-->
[HTML](https://github.com/jaywcjlove/rehype-attr)<!--rehype:target="__blank"-->
Markdown[^1] 可以提高排版效率,并将文本转换为 HTML[^html]
[^1]: Markdown 是一种纯文本标记语言
[^html]: HyperText Markup Language 超文本标记语言
示例展示:来自 GFM1 特性