Markdown 特性
文档是你的产品向用户展示的门面之一。 文从字顺、层次清晰的文章有助于用户快速了解您的产品。 我们的一致目标是帮助用户尽快找到所需要的信息。
Docusaurus 2 使用现代化工具来帮助你轻松撰写交互式文档。 你可以嵌入 React 组件,亦或是搭建用户可交互的实时代码编辑块。 就用代码呈现你的灵光一现,捕获你的受众的心吧! 这可能是吸引潜在用户的最有效的方式。
本章节假定你使用 Docusaurus 官方的内容插件。
标准功能
Markdown 是一种能让你撰写易读的格式化内容的语法。
我们用 MDX 作为模板引擎,它能做的事情要比解析标准 Markdown 语法多得多,比如可以在文档中渲染 React 组件。
### 我的文档章节
一些文本,包括**粗体**、_斜体_,和[链接](/)

Markdown 是声明式的
有些人可能会假定 Markdown 和 HTML 之间存在一对一的对应,例如 
始终会变成 <img src="/img/docusaurus.png" alt="Preview" />
。 然而,事实并非如此。

这种 Markdown 语法只会声明式地告诉 Docusaurus 需要在此处插入一个图像。但我们可能会做其他事情,比如把文件路径转换为 URL 路径,所以我们生成的标记可能不同于其他 Markdown 渲染器的输出,也可能不同于简单转写出的等效 JSX/HTML 代码。
Quotes
Markdown quotes are beautifully styled:
> Easy to maintain open source documentation websites.
>
> — Docusaurus
易于维护开源文档网站。
— Docusaurus
Details
Markdown can embed HTML elements, and details
HTML elements are beautifully styled:
### Details element example
<details>
<summary>Toggle me!</summary>
<div>
<div>This is the detailed content</div>
<br/>
<details>
<summary>
Nested toggle! 内含惊喜……
</summary>
<div>
😲😲😲😲😲
</div>
</details>
</div>
</details>
Details element example
Toggle me!
Nested toggle! 内含惊喜……
In practice, those are not really HTML elements, but React JSX elements, which we'll cover next!