自定义页面

YDoc 的页面可支持 .md、.jsx、.html 三种类型。我们推荐大部分的文档内容 使用 markdown 编写,少数个性化页面使用 html 或 jsx 实现。

Markdown 规则

YDoc 会根据 markdown 内容获取网站标题和描述信息,如下所示,YDoc 会将当前页面标题设置为 “示例”, 页面描述信息设置为 “这是一个示例。”。

  1. # 示例
  2. 这是一个示例。
  3. ## 章节1
  4. ## 章节2

Html 规则

YDoc 支持解析 .html 文件,你可以使用 html 所有特性高度自定义页面内容。

JSX 规则

JSX 就是 Javascript 和 XML 结合的一种格式。React发明了JSX,利用HTML语法来创建虚拟DOM。

Ydoc 使用了开源工具 noox 解析 .jsx 文件,详细使用方法参考 jsx