Docusaurus🦖
@@ -64,6 +64,7 @@| ........................ process ........................... |
| .......... parse ... | ... run ... | ... stringify ..........|
+--------+ +----------+
Input ->- | Parser | ->- Syntax Tree ->- | Compiler | ->- Output
+--------+ | +----------+
X
|
+--------------+
| Transformers |
+--------------+
上図(Unified Overviewより)にTransformersとあるところがRemark/Rehypeの動作するところ。
Remarkはmarkdown形式で、RehypeはHTML形式でASTを扱います。どちらも同じようにASTを操作できますが、データ構造が違うため、目的に応じて選択することになるのかなと思います。
+こちらのサイトなどが詳しいです。
Docusaurusにおけるプラグインの実行タイミング
Docusaurusでこれらのプラグインを利用するためにはdocusaurus.config.jsonに設定が必要です。このページによると次の4種類の設定値にてプラグインを登録できます。
デフォルトプラグイン適用前 | デフォルトプラグイン適用後 | |
---|---|---|
Remark Markdown形式 | beforeDefaultRemarkPlugins | remarkPlugins |
Rehype HTML形式 | beforeDefaultRehypePlugins | rehypePlugins |