使用 Markdown 解析文章,除了支持 Github GFM
,还有一些特殊的使用方法,后期可以定义一些特殊的使用方法。
下面介绍的不是 Markdown 的标准语法,一些属于 idoc 自定义的语法,还有一些属于 Github GFM
中的一些语法。
我们使用 <!--idoc:ignore:start-->
与 <!--idoc:ignore:end-->
这个注释语法,忽略被包裹在中间的内容,这很有用,在 GitHub Markdown 预览文件中注释不会显示,在编译后的 HTML 中,忽略被包裹的 Markdown 内容:
<!--idoc:ignore:start-->
idoc
===
<!--idoc:ignore:end-->
默认 Markdown 语法解析有很多限制,idoc
通过使用 rehype-attr 让文档可以使用 HTML 注释 <!--rehype:xxx-->
自定义样式。
## Title
<!--rehype:style=display: flex; height: 230px; align-items: center; justify-content: center; font-size: 38px;-->
Markdown Supports **Style**<!--rehype:style=color: red;-->
有一些其它地方对 Markdown 语法介绍教程,可以看看。