diff --git a/website/docs/blog.mdx b/website/docs/blog.mdx index 2c1bb0179e89..742692f55570 100644 --- a/website/docs/blog.mdx +++ b/website/docs/blog.mdx @@ -76,7 +76,7 @@ The [front matter](./guides/markdown-features/markdown-features-intro.mdx#front- The blog's index page (by default, it is at `/blog`) is the _blog list page_, where all blog posts are collectively displayed. -Use the `` marker in your blog post to represent what will be shown as the summary when viewing all published blog posts. Anything above `` will be part of the summary. For example: +Use the `` marker in your blog post to represent what will be shown as the summary when viewing all published blog posts. Anything above `` will be part of the summary. Note that the portion above the truncate marker must be standalone renderable Markdown. For example: ```md title="website/blog/my-post.md" {7} --- diff --git a/website/versioned_docs/version-2.0.1/blog.mdx b/website/versioned_docs/version-2.0.1/blog.mdx index cc91a003249a..66d728ddf91a 100644 --- a/website/versioned_docs/version-2.0.1/blog.mdx +++ b/website/versioned_docs/version-2.0.1/blog.mdx @@ -76,7 +76,7 @@ The [front matter](./guides/markdown-features/markdown-features-intro.mdx#front- The blog's index page (by default, it is at `/blog`) is the _blog list page_, where all blog posts are collectively displayed. -Use the `` marker in your blog post to represent what will be shown as the summary when viewing all published blog posts. Anything above `` will be part of the summary. For example: +Use the `` marker in your blog post to represent what will be shown as the summary when viewing all published blog posts. Anything above `` will be part of the summary. Note that the portion above the truncate marker must be standalone renderable Markdown. For example: ```md --- diff --git a/website/versioned_docs/version-2.1.0/blog.mdx b/website/versioned_docs/version-2.1.0/blog.mdx index cc91a003249a..66d728ddf91a 100644 --- a/website/versioned_docs/version-2.1.0/blog.mdx +++ b/website/versioned_docs/version-2.1.0/blog.mdx @@ -76,7 +76,7 @@ The [front matter](./guides/markdown-features/markdown-features-intro.mdx#front- The blog's index page (by default, it is at `/blog`) is the _blog list page_, where all blog posts are collectively displayed. -Use the `` marker in your blog post to represent what will be shown as the summary when viewing all published blog posts. Anything above `` will be part of the summary. For example: +Use the `` marker in your blog post to represent what will be shown as the summary when viewing all published blog posts. Anything above `` will be part of the summary. Note that the portion above the truncate marker must be standalone renderable Markdown. For example: ```md --- diff --git a/website/versioned_docs/version-2.2.0/blog.mdx b/website/versioned_docs/version-2.2.0/blog.mdx index cc91a003249a..66d728ddf91a 100644 --- a/website/versioned_docs/version-2.2.0/blog.mdx +++ b/website/versioned_docs/version-2.2.0/blog.mdx @@ -76,7 +76,7 @@ The [front matter](./guides/markdown-features/markdown-features-intro.mdx#front- The blog's index page (by default, it is at `/blog`) is the _blog list page_, where all blog posts are collectively displayed. -Use the `` marker in your blog post to represent what will be shown as the summary when viewing all published blog posts. Anything above `` will be part of the summary. For example: +Use the `` marker in your blog post to represent what will be shown as the summary when viewing all published blog posts. Anything above `` will be part of the summary. Note that the portion above the truncate marker must be standalone renderable Markdown. For example: ```md --- diff --git a/website/versioned_docs/version-2.3.1/blog.mdx b/website/versioned_docs/version-2.3.1/blog.mdx index 02f870da6f6f..cb3110859a16 100644 --- a/website/versioned_docs/version-2.3.1/blog.mdx +++ b/website/versioned_docs/version-2.3.1/blog.mdx @@ -76,7 +76,7 @@ The [front matter](./guides/markdown-features/markdown-features-intro.mdx#front- The blog's index page (by default, it is at `/blog`) is the _blog list page_, where all blog posts are collectively displayed. -Use the `` marker in your blog post to represent what will be shown as the summary when viewing all published blog posts. Anything above `` will be part of the summary. For example: +Use the `` marker in your blog post to represent what will be shown as the summary when viewing all published blog posts. Anything above `` will be part of the summary. Note that the portion above the truncate marker must be standalone renderable Markdown. For example: ```md --- diff --git a/website/versioned_docs/version-2.4.0/blog.mdx b/website/versioned_docs/version-2.4.0/blog.mdx index 02f870da6f6f..cb3110859a16 100644 --- a/website/versioned_docs/version-2.4.0/blog.mdx +++ b/website/versioned_docs/version-2.4.0/blog.mdx @@ -76,7 +76,7 @@ The [front matter](./guides/markdown-features/markdown-features-intro.mdx#front- The blog's index page (by default, it is at `/blog`) is the _blog list page_, where all blog posts are collectively displayed. -Use the `` marker in your blog post to represent what will be shown as the summary when viewing all published blog posts. Anything above `` will be part of the summary. For example: +Use the `` marker in your blog post to represent what will be shown as the summary when viewing all published blog posts. Anything above `` will be part of the summary. Note that the portion above the truncate marker must be standalone renderable Markdown. For example: ```md ---