可重复使用的片段

以 Markdown 格式查看

使用单一来源保持您的文档 DRY(Don’t Repeat Yourself):定义一次可重复使用的 Markdown 片段,然后在多个地方引用它。这样,您只需要在一个地方更新片段即可保持所有引用同步。

可重复使用的片段适用于常量(API 限制、订阅价格、版本号)、重复的警告或注释以及标准化格式块。

1

创建文件结构

在您的 fern 项目的任意位置创建一个名为 snippets 的文件夹。在 snippets 文件夹内,为您想要定义的每个片段创建一个新的 Markdown 文件。

fern
pages
my-tutorial.mdx
assets
snippets
herbs.mdx
peace-lily.mdx
trees.mdx
2

创建片段

在每个片段文件中,定义您想要重复使用的内容。

snippets/peace-lily.mdx
1Peace lilies are easy to grow and relatively trouble-free.
3

向片段添加参数(可选)

为了使片段更加灵活,您可以使用参数(也称为变量)。参数使用 {{parameterName}} 语法,可以放在片段内容的任何位置。

snippets/watering-schedule.mdx
1<Warning>Remember to water your {{plant}} every {{interval}} days.</Warning>

然后,您可以在每次使用片段时为这些参数传递不同的值。

4

使用片段

要在您的文档中使用片段,请通过其文件路径(包括 .mdx 扩展名)引用它。如果您在片段中使用了参数(变量),请为每个参数传递值:

1<Markdown src="/snippets/peace-lily.mdx">
2
3They symbolize peace and prosperity.
4
5<Markdown src="/snippets/watering-schedule.mdx" plant="peace lily" interval="3">
文件路径

src 路径是以 fern 文件夹为根目录的绝对路径。无论您从哪个页面引用,路径都是相同的:

文件夹结构引用
fern/snippets/peace-lily.mdxsrc="/snippets/peace-lily.mdx"
fern/docs/snippets/peace-lily.mdxsrc="/docs/snippets/peace-lily.mdx"
fern/docs/guides/snippets/peace-lily.mdxsrc="/docs/guides/snippets/peace-lily.mdx"