Skip to content
Netflix - 每月低至 25 元

摘要

摘要会在文章列表的标题下方展示,分为自动摘要和手动摘要,其中手动摘要优先级高于自动摘要

摘要的内容会将文章的各级标题、代码块移除,仅展示文章正文内容

TIP

无论摘要内容多少,在文章列表最多展示两行

自动摘要

通过 usePosts 方法的 autoExcerpt 参数进行启用,值为摘要的字数,默认为 0 不开启。当填入数字后,所有文章都会开启自动摘要

ts
// .vitepress/config.ts
const { posts, rewrites } = await usePosts({ autoExcerpt: 100 });

手动摘要

手动摘要可以单独为一篇文章启用摘要功能,无需与自动摘要同时启用。当自动摘要与手动摘要同时开启时,也会优先展示手动摘要的内容。

手动摘要分为 description<!-- more -->,前者用于完全自定义的摘要内容,与正文内容无关;后者则用于指示正文摘要的结束位置。同时前者的优先级也高于后者,如果文章存在 description,会优先展示

description

通过在 frontmatter 中设置 description 可以为文章添加自定义的摘要内容

yaml
---
description: '自定义摘要内容'
---

<!-- more -->

在 Markdown 文章中可以手动添加 <!-- more --> 标记,用于指示摘要的结束位置,当标记存在时,标记前面的内容均为摘要内容,可以不受自动摘要的字数限制

关注微信公众号RackNerd - 美国 163 直连线路
你认为这篇文章怎么样?
  • 0
  • 0
  • 0
  • 0
  • 0
  • 0

预览:

评论
  • 按正序
  • 按倒序
  • 按热度
Powered by Waline v3.1.3