Lazy loaded image
技术分享
front-matter 介绍
Words 822Read Time 3 min
2025-9-10
2025-9-11
type
status
date
slug
summary
tags
category
icon
password
文件和媒体

Front-matter

Front-matter 是 markdown 文件最上方以 --- 分隔的区域,用于指定个别档案的变数。
  • Page Front-matter 用于配置页面
  • Post Front-matter 用于配置文章
[!NOTE]
如果标注的参数,可根据自己需要添加,不用全部都写在 markdown 里

Page Front-matter

MARKDOWN
YAML

写法
解释
title
【必需】页面标题
date
【必需】页面创建日期
type
【必需】标签、分类和友情链接三个页面需要配置
updated
【可选】页面更新日期
description
【可选】页面描述
keywords
【可选】页面关键词
comments
【可选】显示页面评论模块 (默认 true)
top_img
【可选】页面顶部图片
mathjax
【可选】显示mathjax (当设置mathjax的per_page: false时,才需要配置,默认 false)
katex
【可选】显示katex (当设置katex的per_page: false时,才需要配置,默认 false)
aside
【可选】显示侧边栏 (默认 true)
aplayer
【可选】在需要的页面加载aplayer的js和css,请参考文章下面的 配置音乐
highlight_shrink
【可选】配置代码框是否展开 (true/false) (默认为设置中highlight_shrink的配置)
random
【可选】配置友情链接是否随机排序(默认为 false)

Post Front-matter

MARKDOWN
YAML

写法
解释
title
【必需】文章标题
date
【必需】文章创建日期
updated
【可选】文章更新日期
tags
【可选】文章标签
categories
【可选】文章分类
keywords
【可选】文章关键词
description
【可选】文章描述
top_img
【可选】文章顶部图片
cover
【可选】文章缩略图(如果没有设置top_img,文章页顶部将显示缩略图,可设为false/图片地址/留空)
comments
【可选】显示文章评论模块(默认 true)
toc
【可选】显示文章TOC(默认为设置中toc的enable配置)
toc_number
【可选】显示toc_number(默认为设置中toc的number配置)
toc_style_simple
【可选】显示 toc 简洁模式
copyright
【可选】显示文章版权模块(默认为设置中post_copyright的enable配置)
copyright_author
【可选】文章版权模块的文章作者
copyright_author_href
【可选】文章版权模块的链接文章作者
copyright_url
【可选】文章版权模块的链接文章链接
copyright_info
【可选】文章版权模块的文字版权声明
mathjax
【可选】显示mathjax(当设置 mathjax 的 per_page: false 时,才需要配置,默认 false )
katex
【可选】显示 katex (当设置 katex 的 per_page: false 时,才需要配置,默认 false )
aplayer
【可选】在需要的页面加载 aplayer 的 js 和 css
highlight_shrink
【可选】配置代码框是否展开(true/false)(默认为设置中 highlight_shrink 的配置)
aside
【可选】显示侧边栏 (默认 true)
abcjs
【可选】加载 abcjs (当设置 abcjs 的 per_page: false 时,才需要配置,默认 false
上一篇
【Hugo】+ Github 免费部署自己的博客
下一篇
【Hugo】+ Github 免费部署自己的博客