Markdown 与 Front Matter:写作格式标准

Hugo 采用 Markdown 作为主要的内容写作格式,并通过 Front Matter 来管理内容的元数据。了解如何正确使用这些格式标准,是创建高质量内容的基础。

Markdown 处理与自定义

基础 Markdown 支持

Hugo 使用 Goldmark 作为默认的 Markdown 处理器,支持 CommonMark 规范以及多种扩展功能。

渲染钩子的影响

Hugo 的渲染钩子允许你自定义 Markdown 元素的 HTML 输出,这为内容创作提供了更大的灵活性:

  • 图像渲染:可以自动为图片添加响应式处理、懒加载或图片说明
  • 链接处理:可以为外部链接自动添加安全属性或样式
  • 代码块增强:可以集成语法高亮、代码复制功能或在线编辑器
  • 自定义块:可以创建特殊的内容块,如警告框、提示框等

关于渲染钩子的详细使用方法,请参见渲染钩子章节。

Front Matter 元数据规范

Hugo 的 Front Matter 使用 YAML 格式来定义页面的元数据。正确设置这些元数据,可以帮助 Hugo 更好地处理和展示你的内容。

必需的元数据字段

每个页面至少需要包含以下几个基本字段:

  • title:页面的标题
  • date:页面的发布日期
  • draft:是否为草稿,草稿会被 Hugo 忽略,不会生成静态页面

常用的元数据字段

除了基本字段,你还可以根据需要添加其他字段:

  • description:页面的描述,用于搜索引擎优化
  • keywords:页面的关键词,用于搜索引擎优化
  • linktitle:页面在链接中的显示标题
  • weight:页面的权重,用于排序

元数据字段的使用注意事项

  • 确保所有必需字段都已填写
  • 字段值应根据实际情况准确填写
  • 避免在草稿页面中使用不必要的元数据

通过合理使用 Front Matter 元数据,你可以更有效地管理和优化你的内容。

文章导航

章节内容

这是章节的内容页面。

章节概览