message: docs(theme): update excerpt
diff: @@ -33,13 +33,28 @@ For sticky articles, you can set `sticky` with a number to set their order. Arti
  ## Excerpt
  -If you want to add a excerpt for article, you can use `<!-- more -->` comment to mark it. All contents before the comment will be regarded as excerpt. Also, you can specific it with `excerpt` in frontmatter with a HTML string.
  +### Add Excerpt
  -::: info Auto Excerpt
  +If you want to add an excerpt for an article, you can mark contents with `<!-- more -->` comment. Any content before this comment will be considered as an excerpt.
  -By default, the theme will only display the excerpt or description you specify in the article list.
  +Meanwhile, if the excerpt you want to set is not what you want to show at the beginning of the article, you can also set the HTML string through the `excerpt` option in Frontmatter.
  -If you want the theme to automatically extract excerpts, set `plugins.blog.autoExcerpt: true` in theme options.
  +### Automatically Generate Excerpt
  +
  +By default, the theme will only display excerpt you specify or the description set in frontmatter for articles in article list.
  +
  +If you want the theme extracting excerpts automatically, set `plugins.blog.autoExcerpt: true` in theme options.
  +
  +::: warning Excerpt Limitation
  +
  +We recommend you to use `<!-- more -->` to mark excerpt as first choice. If you do need a special summary, set it in frontmatter yourself.
  +
  +For the comment-marked excerpt, we will separate excerpt from markdown content then render it to HTMLString, so any content outside excerpt **is not considered during rendering**, such restrictions like:
  +
  +- `[[toc]]` tag cannot get the title of the rest of the article
  +- Links and footnotes can not render correctly if their citations are outside excerpt
  +
  +In addition, since both cases excerpt is directly inserted into the DOM through `innerHTML`, this means that any components will be parsed as native tags and cannot not be rendered as Vue Component.
  :::
  