扩展写作功能包括 GitHub 仓库卡片、Mermaid 图表、提示容器、防剧透内容,以及图片尺寸和图注。下方示例展示实际渲染效果。
原版技术参考与完整示例(英文)
GitHub Repository Cards
You can add dynamic cards that link to GitHub repositories, on page load, the repository information is pulled from the GitHub API.
Create a GitHub repository card with the code ::github{repo="<owner>/<repo>"}.
::github{repo="saicaca/fuwari"}Mermaid Diagrams
Fenced mermaid blocks are rendered as diagrams and follow the active color scheme.
flowchart LR
accTitle: Markdown rendering pipeline
accDescr: Markdown source is transformed into semantic HTML and then enhanced as a themed SVG diagram.
A[Markdown source] --> B[Astro content pipeline]
B --> C[Semantic HTML]
C --> D[Themed diagram]Admonitions
Following types of admonitions are supported: note tip important warning caution
Basic Syntax
:::noteHighlights information that users should take into account, even when skimming.:::
:::tipOptional information to help a user be more successful.:::Custom Titles
The title of the admonition can be customized.
:::note[MY CUSTOM TITLE]This is a note with a custom title.:::GitHub Syntax
> [!NOTE]> The GitHub syntax is also supported.
> [!TIP]> The GitHub syntax is also supported.Spoiler
You can add spoilers to your text. The text also supports Markdown syntax.
The content !
The content :spoiler[is hidden **ayyy**]!Image Widths and Captions
A standalone image accepts an optional w-N% width token in its alt text and a Markdown title rendered as a centered caption below the image:

Valid widths range from w-1% to w-100%; invalid tokens stay in the alt text. The width and the caption are independent — a title alone also produces a caption:


分享文章
生成精美分享图或复制链接,与更多人分享本文。
继续阅读
换条路线
从其他文章中稳定抽取
最后更新于 ,距今已过 698 天
部分内容可能已过时