这页用来检查博客的阅读和交互细节。源码在前,效果在后;两处使用相同的示例内容,方便对照。代码展示部分则直接列出不同语言的示例。
可以从头阅读,也可以直接查看代码块、图片、自定义组件和检查清单。切换浅色、深色模式或缩小窗口时,留意换行、对比度和横向滚动。
标题
正文会用到不同层级的标题。这里特意展示 H1–H6;普通文章的一级标题由页面提供,正文通常从二级标题开始。
源码:
# 一级标题 H1
## 二级标题 H2
### 三级标题 H3
#### 四级标题 H4
##### 五级标题 H5
###### 六级标题 H6效果:
一级标题 H1
二级标题 H2
三级标题 H3
四级标题 H4
五级标题 H5
六级标题 H6
看什么:标题大小和粗细是否有层次;点击目录后,标题是否出现在顶部导航下方。
段落与中英混排
源码:
在这里记录学习与生活,也记录使用 Next.js、TypeScript 和 Git 时遇到的问题。版本 v1.2.3,日期 2026-11-15,进度 50%。
这是下一段。中英文标点对照:「记录」、“想法”、(补充)、Hello, world!、路径 /blog/me/test。
行内代码:`const total = 42`,中文注释:`// 记录总数`。效果:
在这里记录学习与生活,也记录使用 Next.js、TypeScript 和 Git 时遇到的问题。版本 v1.2.3,日期 2026-11-15,进度 50%。
这是下一段。中英文标点对照:「记录」、“想法”、(补充)、Hello, world!、路径 /blog/me/test。
行内代码:const total = 42,中文注释:// 记录总数。
看什么:段落间是否有清晰留白,中文、英文和数字的视觉大小是否协调。正文使用浏览器的无衬线字体设置;代码优先使用本地等宽字体,缺少的字形再回退。不同设备上的具体字形可以不同。
文本样式
源码:
**粗体** _斜体_ **_粗斜体_** ~~删除线~~ `行内代码`
**粗体里有 `代码`**、_斜体里有[链接](/blog)_、**粗体加~~删除线~~混排**效果:
粗体 斜体 粗斜体 删除线 行内代码
粗体里有 代码、斜体里有链接、粗体加删除线混排
看什么:强调是否可辨认,行内代码是否与文字对齐。中文字体未提供斜体时,浏览器可能合成倾斜效果。
HTML 内联元素
源码:
<mark>高亮</mark>,按 <kbd>Ctrl</kbd> + <kbd>C</kbd> 复制。
E = mc<sup>2</sup>,H<sub>2</sub>O。
<abbr title="HyperText Markup Language">HTML</abbr>,<u>下划线</u>、
<ins>插入</ins>、<del>删除</del>。
第一行<br />第二行由 br 换行。效果:
高亮,按 Ctrl + C 复制。
E = mc2,H2O。
HTML,下划线、
插入、删除。
第一行
第二行由 br 换行。
转义、实体与表达式
源码:
转义:\*不是斜体\*、\#不是标题。
实体:© ™ — … < > &
Emoji:🎉 ✅ 🚀 💡 🐛
MDX 表达式:2 的 10 次方是 {Math.pow(2, 10)}。效果:
转义:*不是斜体*、#不是标题。
实体:© ™ — … < > &
Emoji:🎉 ✅ 🚀 💡 🐛
MDX 表达式:2 的 10 次方是 1024。
表达式的结果应为 1024。这是 MDX 的能力,普通 Markdown 不会计算表达式。
链接
源码:
- [返回博客列表](/blog)
- [带标题的外链](https://github.com 'GitHub 首页')
- 裸链接:https://nextjs.org
- [跳到代码块](#代码块)
- 引用式:[Next.js][next] 与 [Tailwind][tw]
[next]: https://nextjs.org
[tw]: https://tailwindcss.com效果:
看什么:站内链接在当前页跳转,外链在新标签页打开;页内锚点应定位到对应标题。也可以用 Tab 键检查焦点是否清晰。
列表与任务
源码:
- 无序项一
- 无序项二
- 子项 A
- 子项 B
1. 有序项一
2. 有序项二
1. 子步骤
- [x] 已完成
- [ ] 未完成
- [x] 嵌套已完成
- [ ] 嵌套未完成效果:
- 无序项一
- 无序项二
- 子项 A
- 子项 B
- 有序项一
- 有序项二
- 子步骤
- 已完成
- 未完成
- 嵌套已完成
- 嵌套未完成
看什么:编号、圆点和缩进是否清楚。任务列表的复选框用于展示文章里的状态,不是可保存的待办表单。
引用
源码:
> 单行引用。
> 第一段引用。
>
> 第二段引用,里面有 **强调** 和 `代码`。
>
> > 嵌套引用。效果:
单行引用。
第一段引用。
第二段引用,里面有 强调 和
代码。嵌套引用。
代码块
代码是否高亮取决于语言标记,与行数无关。用四个反引号包住三个反引号,可以展示代码块的写法:
```bash
printf '%s\n' 'Hello, Seven'
```下面直接展示不同语言的效果。这里只展示代码,不会自动执行;可用右上角的复制按钮检查缩进、空行和原始字符是否保留。
单行 Bash 命令
printf '%s\n' 'Hello, Seven'JavaScript 与中文注释
// 中文注释与英文代码混排
function greet(name) {
return `你好,${name}!`
}
console.log(greet('Seven'))Python 缩进
class Stack:
def __init__(self):
self._items = []
def push(self, item):
self._items.append(item)Shell 多行命令
#!/usr/bin/env bash
set -euo pipefail
for name in 'Seven' '中文示例'; do
printf 'Hello, %s\n' "$name"
donePowerShell
# 查看当前目录中的文件
Get-ChildItem -File | Select-Object Name, LengthHTML 标签与属性
<a href="/blog" title="返回博客列表">博客</a>JSON 数据
{
"name": "seven",
"enabled": true,
"tags": ["博客", "MDX"],
"count": 3
}YAML 配置
site:
name: Seven
enabled: true
languages:
- zh-CN
- enTOML 配置
[site]
name = "Seven"
enabled = true
languages = ["zh-CN", "en"]INI 配置
# 配置示例
[site]
name=Seven
language=zh-CNDiff 差异
- const version = '1.0.0'
+ const version = '1.1.0'
export default version普通输出与无语言代码块
标记为 text 的输出会保留换行和空格,不做语法着色:
Build completed.
Pages: 3
Errors: 0下面刻意不写语言标记,用来检查无高亮时的样式。它不需要补成 bash 或其他语言:
这是一段没有语言标记的文本。
Hello, Seven. 0123456789
这一行有四个前导空格。
超长行与横向滚动
下面刻意保留为一行。在窄屏上,应该只让代码块横向滚动,不把整张页面撑宽。
const longMessage = 'This is an intentionally long line for checking horizontal scrolling: English words, 中文注释, numbers 0123456789, and punctuation should stay on one source line.'看什么:浅色和深色模式下,注释、字符串和关键字都应可辨认;不是每个字符都必须有颜色。英文代码优先使用本地等宽字体,中文回退字体不保证与英文构成严格的双倍字宽。
表格
源码:
| 左对齐 | 居中 | 右对齐 |
| :----- | :--: | -----: |
| a | b | 1.00 |
| 长一些 | 居中 | 20.50 |效果:
| 左对齐 | 居中 | 右对齐 |
|---|---|---|
| a | b | 1.00 |
| 长一些 | 居中 | 20.50 |
单元格里的混排:
| 名称 | 说明 |
|---|---|
| 粗体 | 含加粗文字 |
| 代码 | 含 inline code |
| 链接 | 含链接 |
宽表格示例,检查手机上的横向滚动:
| 文件 | 类型 | 用途 | 备注 |
|---|---|---|---|
| content/test.mdx | Markdown | 源码与效果对照 | 检查排版及交互 |
| app/global.css | CSS | 全站样式 | 浅色和深色模式 |
| tailwind.config.mjs | JavaScript | 字体回退与 Tailwind 配置 | 使用设备上的本地字体 |
图片
这里的图片均来自站内,便于区分渲染问题和外部图片服务的网络问题。
源码:


[](/blog)效果:


瀑布图注,用来检查图片与说明的间距。

看什么:图片比例是否正常、图注是否清楚;最后一张图片应能跳转到博客列表。
分隔线
源码:
上一段。
---
下一段。效果:
上一段。
下一段。
脚注
源码:
正文引用一个脚注[^1],再引用第二个[^2]。
[^1]: 这是第一个脚注的内容。
[^2]: 这是第二个脚注的内容。效果:
看什么:脚注编号能否跳到文末说明,说明后的返回链接能否回到引用处。
折叠内容
这里使用站内的 Details 组件。源码中保留空行,让折叠区域里的列表和代码按 Markdown 渲染。
源码:
<Details>
<summary>展开折叠示例</summary>
折叠区域里的内容:
- 列表项一
- 列表项二
```js
console.log('折叠区域里的代码')
```
</Details>效果:
看什么:鼠标点击或键盘 Enter 能否展开、收起;展开后的代码是否有高亮和复制按钮。
自定义组件
以下组件属于本站的 MDX 渲染能力,直接复制到普通 Markdown 编辑器里不一定会显示。每组源码与效果使用相同的参数。
Callout 提示框
源码:
<Callout emoji="💡">这是一条补充说明,用来检查图标和文字的对齐。</Callout>效果:
ProsCard 与 ConsCard
源码:
<ProsCard
title="MDX"
pros={['保留 Markdown 写作方式', '可以复用 React 组件']}
/>
<ConsCard title="MDX" cons={['只需要纯文本笔记', '不需要交互组件']} />效果:
TechCard 技术栈卡片
源码:
<TechCard
techList={[
{ category: '框架', tech: 'Next.js' },
{ category: '样式', tech: 'Tailwind CSS' },
{ category: '内容', tech: 'MDX' },
]}
/>效果:
项目技术
Table 数据表格
源码:
<Table
data={{
headers: ['字段', '类型', '必填'],
rows: [
['title', 'string', '是'],
['image', 'string', '否'],
['category', 'string', '是'],
],
}}
/>效果:
| 字段 | 类型 | 必填 |
|---|---|---|
| title | string | 是 |
| image | string | 否 |
| category | string | 是 |
ImageTabs 图片切换
源码:
<ImageTabs
items={[
{ label: '其一', src: '/blog-img/jianlai/v36.webp' },
{ label: '其二', src: '/blog-img/jianlai/v37.webp' },
{ label: '其三', src: '/blog-img/jianlai/v2.webp' },
{ label: '其四', src: '/blog-img/jianlai/v3.webp' },
{ label: '其五', src: '/blog-img/jianlai/v4.webp' },
{ label: '较长标签的换行示例', src: '/blog-img/and/script.webp' },
]}
/>效果:
看什么:点击标签后图片是否切换,窄屏标签是否自然换行。桌面宽度下可点击图片放大,再按 Esc 关闭;手机宽度下仅切换图片。组件支持远程 URL,本页实际展示只用本地素材。
检查清单
- 文字:中英文、数字和标点协调;强调、行内代码与段落留白可辨认。
- 代码:单行和多行均按语言高亮;无语言文本保持普通颜色;复制时不带行号。
- 窄屏:长代码和宽表格在各自区域滚动,整页不被撑宽。
- 图片:比例、图注和图片链接正常,切换组件不会串图。
- 交互:目录、页内链接、脚注、折叠和图片预览能完成一次往返。
- 配色:浅色、深色模式下的正文、注释和提示文字都能读清。
这些示例覆盖本站常用的 Markdown 和 MDX 写法,方便每次调整后人工复查。当前页面正常,不代表所有内容和浏览器组合都已验证;遇到新问题时,可以补一个小示例来复现。