https://liquid-stack.pages.dev/zh/tags/markdown/Recent content in Markdown 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>https://liquid-stack.pages.dev/zh/p/writing-markdown-and-bilingual-posts/Thu, 23 Jul 2026 00:00:00 +0000https://liquid-stack.pages.dev/zh/p/writing-markdown-and-bilingual-posts/<p>Liquid Stack 使用 Hugo 的多语言内容结构：同一篇文章的中英文版本放在同一个目录。</p> <h2 id="创建文章目录">创建文章目录 </h2><p>在 <code>content/post/文章-slug/</code> 新建 <code>index.md</code> 和 <code>index.zh.md</code>。两个文件使用同一个 <code>slug</code>，这样语言切换器能识别它们是一对翻译文章。</p> <h2 id="写好前置数据">写好前置数据 </h2><p>每篇文章至少应有标题、简介、日期、分类和标签。中文与英文应分别本地化标题和简介，而不是逐字翻译；产品名、命令和代码保持原样。</p> <h2 id="保持可维护">保持可维护 </h2><p>文章图片放在 <code>static/img/文章-slug/</code>，并用 <code>/img/文章-slug/featured.png</code> 一类的站点绝对路径引用。发布前检查两种语言是否都有正确链接、图片和分类。</p>