Markdown 写作示范：一篇标准的博文长什么样

每篇文章开头都有一段用 --- 包起来的 front matter，元数据全写在这里：

---
title:       "文章主标题"
date:        2026-08-28
tags:        ["笔记", "示例"]
summary:     "首页卡片上显示的那句摘要。"
description: "给搜索引擎看的 SEO 简介。"
---

各字段注意三点：

• date 负责控制文章在列表里的排序，填错时间文章可能会"沉底"或者排到未来去。
• tags 在本站只渲染首页卡片和文章页上的小徽章，不会生成标签归档页（站点配置里关掉了）。
• summary 是首页卡片上那一小段节选，写好点；description 是给搜索引擎看的 SEO 简介，两者内容可以一样。

欢迎来到我博客的第一篇示范文章。你看到的一切——标题、列表、代码块——都是用 Markdown 写出来的，比 HTML 简单得多。

一、最基本的文字

直接打字就是一个段落，前后空一行就是分段。

可以用 **双星号** 写加粗，用 *单星号* 写斜体，用 ~~波浪线~~ 写删除线， 用反引号包住 行内代码，比如配置项 baseURL = "https://wanyin.pw/"。

二、标题

正文中用 ## 开头的就是小标题（一级大标题留给文章标题，正文从二级开始用）：

三级标题长这样

层级多了会自动有更小的字号，不过一篇博文用到三级就够了。

三、列表

无序列表，一行一个 -：

• 第一个要点
• 第二个要点
  • 前面加两个空格就是二级
• 第三个要点

有序列表直接写数字：

1. 复制一篇现有文章的 .md 文件
2. 改掉 front matter 里的标题和日期
3. 重写正文
4. git push 上线

四、链接和引用

写链接只要方括号加圆括号：Hugo 官网。

引用用 > 开头，适合放金句或注意事项：

好的写作不是想出来再写，而是写着写着就想清楚了。

五、代码块（写技术文章的重点）

三个反引号开头并标明语言，就有语法高亮。比如一段命令：

hugo server -D        # 本地预览，带草稿
hugo --minify         # 正式构建

再比如一段代码：

// 计算阅读时长：中文按每分钟 400 字估算
const WORDS_PER_MINUTE = 400;

function estimateReadingMinutes(text) {
  const wordCount = text.replace(/\s/g, "").length;
  return Math.max(1, Math.round(wordCount / WORDS_PER_MINUTE));
}

六、图片

![图片说明文字](https://example.com/photo.jpg)

本站是"一篇一个文件"的结构，没有 page bundle，相对路径引用图片会 404。可行做法：把图片放进 static/images/ 目录，然后用绝对路径 /images/xxx.png 引用。

七、表格