使用 Markdown 解析文章,除了支持 Github GFM
,还有一些特殊的使用方法,后期可以定义一些特殊的使用方法。
下面介绍的不是 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 语法介绍教程,可以看看。