Garden 使用说明内置组件
链接卡片
把一条跳转链接渲染成带网站名、标题和简介的卡片。
单独占一段的网址,或链接末尾紧跟 {card},会渲染成链接卡片(同站与外站同一套逻辑)。正文里带标题的普通链接不会变成卡片,例如 Typora:外站只在文字前加站点 Favicon,右上角标 ↗,图标与第一个字留在同一行;同站标题链接仍在站内跳转。
1单独一行的网址
前后留空行,整段只有网址:
https://spec.commonmark.org/
2写在句子里的 {card}
) 后面紧跟 {card},中间不加空格。链接留在句子里,卡片跟在这一段后面:
表格、任务列表和脚注都来自 [remark-gfm](https://github.com/remarkjs/remark-gfm){card},它让 GFM 语法在这里生效。
表格、任务列表和脚注都来自 remark-gfm,它让 GFM 语法在这里生效。
3单独一行的 {card}
这一段只有带标记的链接时,这一行直接换成卡片:
[KaTeX 支持的函数](https://katex.org/docs/supported.html){card}
{card} 写在代码里会原样显示,例如 [文字](https://example.com){card}。标记和 ) 之间有空格时也不会变成卡片。同站与外站的跳链共用同一套卡片路径。
构建时读取正文里的 {card} 链接,以及单独成段的网址,把对方页面的标题、简介和封面记入 link-assets.json(同站与外站同一套抓取;HTML meta refresh 会跟着跳到目标页再读 OG)。抓取失败就沿用上次的结果,构建不会因此中断。只刷新这些信息时运行 npx garden links。离线构建时把 GARDEN_OFFLINE 设为 1 会跳过拉取。
随想 Front Matter 里的 type: link 用你写的 title、description 和 image,字段见写文章与随想。
这不是 garden 围栏,没有字段表。围栏组件的字段见组件参考。
