Head 元数据
自定义元数据
Docusaurus 会自动在 <html>
、<head>
、<body>
等地方为你设置好有用的网页元数据。 你也可以在 Markdown 文件中用 <head>
标签添加更多元数据,或者覆盖现有的元数据:
markdown-features-head-metadata.mdx
---
id: head-metadata
title: Head 元数据
---
<head>
<html className="some-extra-html-class" />
<body className="other-extra-body-class" />
<title>Head 元数据自定义的标题!</title>
<meta charSet="utf-8" />
<meta name="twitter:card" content="summary" />
<link rel="canonical" href="https://docusaurus.io/docs/markdown-features/head-metadata" />
</head>
# Head 元数据
文字
这些 <head>
声明已经添加到了这篇 Markdown 文档中,以供演示。 你可以打开浏览器的调试工具,看看本页面的元数据是如何被影响的。
备注
This feature is built on top of the Docusaurus <Head>
component. 要阅读详尽的文档,请参考 react-helmet。
你不需要用这个功能实现一般的 SEO
内容插件(比如文档和博客)提供了 description
、keywords
、image
等前言,会自动被应用于 description
和 og:description
两个字段。但如果你用 <head>
标签,你就得手动声明两个元数据标签。
Markdown 页面描述
Markdown 页面的 description 元数据可能在 head 元数据之外还被用于更多地方。 For example, the docs plugin's generated category index uses the description metadata for the doc cards.
默认情况下,描述是第一行包含内容的文字。我们会尽量把它转化为纯文本。 例如,对于下面的文件:
# 标题
主要内容…… May contain some [links](./file.mdx) or **emphasis**.
它的默认描述为「主要内容…… 还可能包含一些链接或者重点。」 然而,我们并不致力于让它完全能正常工作。 如果它不能产出一段合理的描述,你可以通过前言显式地提供一段:
---
description:这段描述会覆盖默认值。
---
# 标题
主要内容…… May contain some [links](./file.mdx) or **emphasis**.