Note
博客浏览模板
用于检查文章排版、章节目录与页面跳转效果的示例模板
发布于 更新于
阅读说明
这是一篇用于验证博客浏览体验的模板文章。内容覆盖常用的 Markdown 元素,并刻意设置了多层章节,方便检查右侧目录的层级、滚动和跳转效果。
模板用途
- 检查文章标题、段落和留白是否舒适
- 检查右侧目录是否完整显示章节
- 检查点击目录后能否准确跳转
- 检查长文章中的代码块和表格
建议检查方式
先观察右侧目录的层级缩进,再依次点击不同章节。跳转后,章节标题应该自然地出现在阅读区域中。
标题层级
右侧目录会根据标题层级进行缩进,帮助读者理解文章结构。
二级内容
这是一个三级标题对应的内容段落,用于展示章节下的子主题。
更细的说明
这是四级标题。个人博客通常使用到这里已经足够,再继续增加层级会让阅读结构变得复杂。
文字与引用
普通段落适合陈述主要内容。需要强调时,可以使用 粗体文字,也可以使用 行内代码 标记命令或文件名。
引用样式
写作不是一次完成的工作,而是把零散想法逐渐整理清楚的过程。
引用区域可以用来放置结论、提醒或摘录,并与正文保持清晰区分。
列表展示
列表适合整理步骤、清单和并列信息。
无序列表
- 保持标题简短
- 每个章节只讨论一个主题
- 代码示例前说明使用场景
- 文章末尾补充总结
有序列表
- 创建文章文件
- 填写标题、描述和分类
- 编写正文与章节
- 预览并检查目录跳转
代码示例
代码块用于展示可复制的完整片段。
interface BlogPost {
title: string;
description: string;
category: string;
pubDate: string;
updatedDate: string;
tags: string[];
}
const post: BlogPost = {
title: "博客浏览模板",
description: "验证文章浏览效果",
category: "TEST",
pubDate: "2026-07-27",
updatedDate: "2026-07-27",
tags: ["Astro", "Markdown", "Blog"],
};
命令示例
npm run dev
npm run build
表格展示
| 元素 | 用途 | 检查重点 |
|---|---|---|
| 标题 | 划分章节 | 层级是否清晰 |
| 段落 | 承载正文 | 行距是否舒适 |
| 代码块 | 展示代码 | 是否支持横向滚动 |
| 表格 | 对比信息 | 小屏幕是否可浏览 |
长文浏览
当文章内容超过一屏时,右侧目录应保持在可见区域内;如果章节很多,目录区域会独立滚动,而正文仍然可以正常阅读。
目录跳转
点击右侧任意章节后,页面会跳转到对应标题。浏览器地址中也会出现该章节的锚点,便于直接分享具体位置。
返回顶部
页面向下滚动一段距离后,右下角会出现返回顶部按钮。短页面或仍在页面顶部时不会显示。
结语
如果本页的标题层级、目录滚动、代码、表格和跳转都表现正常,就说明当前博客文章模板已经可以用于后续写作。