https://liquid-stack.pages.dev/zh/tags/shortcodes/Recent content in Shortcodes on Liquid StackHugo -- gohugo.iozh-Hans我的博客Fri, 24 Jul 2026 00:00:00 +0000https://liquid-stack.pages.dev/zh/p/using-shortcodes/Fri, 24 Jul 2026 00:00:00 +0000https://liquid-stack.pages.dev/zh/p/using-shortcodes/<p>Shortcodes 是 Hugo 在 Markdown 中插入可复用结构的方式，适合提示框、嵌入内容和重复版式。</p> <h2 id="先看现有-shortcodes">先看现有 Shortcodes </h2><p>浏览 <code>layouts/shortcodes/</code>，了解主题已经提供的能力。优先复用现有组件，避免为一次性排版复制大段 HTML。</p> <h2 id="什么时候使用">什么时候使用 </h2><p>当一段内容需要固定结构、会在多篇文章中重复，或必须渲染为 HTML 时，Shortcode 比手写重复代码更合适。普通段落、列表和代码块仍然直接使用 Markdown。</p> <h2 id="测试渲染结果">测试渲染结果 </h2><p>加入 Shortcode 后用本地预览检查桌面与移动端。若它依赖图片、视频或外部链接，也要检查资源路径与加载失败时的表现。</p>