主页
博客
图集
简历

00:06,杭州

返回列表

Markdown 渲染测试

作者Seven
发布日期2024年10月26日
最后更新2026年11月15日
Hamster1963

这页用来检查博客的阅读和交互细节。源码在前,效果在后;两处使用相同的示例内容,方便对照。代码展示部分则直接列出不同语言的示例。

可以从头阅读,也可以直接查看代码块、图片、自定义组件和检查清单。切换浅色、深色模式或缩小窗口时,留意换行、对比度和横向滚动。

标题

正文会用到不同层级的标题。这里特意展示 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 换行。

转义、实体与表达式

源码:

转义:\*不是斜体\*、\#不是标题。
 
实体:&copy; &trade; &mdash; &hellip; &lt; &gt; &amp;
 
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

效果:

  • 返回博客列表
  • 带标题的外链
  • 裸链接:https://nextjs.org
  • 跳到代码块
  • 引用式:Next.js 与 Tailwind

看什么:站内链接在当前页跳转,外链在新标签页打开;页内锚点应定位到对应标题。也可以用 Tab 键检查焦点是否清晰。

列表与任务

源码:

- 无序项一
- 无序项二
  - 子项 A
  - 子项 B
 
1. 有序项一
2. 有序项二
   1. 子步骤
 
- [x] 已完成
- [ ] 未完成
  - [x] 嵌套已完成
  - [ ] 嵌套未完成

效果:

  • 无序项一
  • 无序项二
    • 子项 A
    • 子项 B
  1. 有序项一
  2. 有序项二
    1. 子步骤
  • 已完成
  • 未完成
    • 嵌套已完成
    • 嵌套未完成

看什么:编号、圆点和缩进是否清楚。任务列表的复选框用于展示文章里的状态,不是可保存的待办表单。

引用

源码:

> 单行引用。
 
> 第一段引用。
>
> 第二段引用,里面有 **强调** 和 `代码`。
>
> > 嵌套引用。

效果:

单行引用。

第一段引用。

第二段引用,里面有 强调 和 代码。

嵌套引用。

代码块

代码是否高亮取决于语言标记,与行数无关。用四个反引号包住三个反引号,可以展示代码块的写法:

```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"
done

PowerShell

# 查看当前目录中的文件
Get-ChildItem -File | Select-Object Name, Length

HTML 标签与属性

<a href="/blog" title="返回博客列表">博客</a>

JSON 数据

{
  "name": "seven",
  "enabled": true,
  "tags": ["博客", "MDX"],
  "count": 3
}

YAML 配置

site:
  name: Seven
  enabled: true
  languages:
    - zh-CN
    - en

TOML 配置

[site]
name = "Seven"
enabled = true
languages = ["zh-CN", "en"]

INI 配置

# 配置示例
[site]
name=Seven
language=zh-CN

Diff 差异

- 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 |

效果:

左对齐居中右对齐
ab1.00
长一些居中20.50

单元格里的混排:

名称说明
粗体含加粗文字
代码含 inline code
链接含链接

宽表格示例,检查手机上的横向滚动:

文件类型用途备注
content/test.mdxMarkdown源码与效果对照检查排版及交互
app/global.cssCSS全站样式浅色和深色模式
tailwind.config.mjsJavaScript字体回退与 Tailwind 配置使用设备上的本地字体

图片

这里的图片均来自站内,便于区分渲染问题和外部图片服务的网络问题。

源码:

![测试图片](/blog-img/test/leaves.png)
 
![alt:瀑布图注,用来检查图片与说明的间距。](/blog-img/test/waterfall.jpg)
 
[![返回博客的图片链接](/blog-img/and/script.webp)](/blog)

效果:

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

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

返回博客的图片链接

看什么:图片比例是否正常、图注是否清楚;最后一张图片应能跳转到博客列表。

分隔线

源码:

上一段。
 
---
 
下一段。

效果:

上一段。


下一段。

脚注

源码:

正文引用一个脚注[^1],再引用第二个[^2]。
 
[^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={['只需要纯文本笔记', '不需要交互组件']} />

效果:

MDX
保留 Markdown 写作方式
可以复用 React 组件
如果存在以下情况,你可能不会选择 MDX:
只需要纯文本笔记
不需要交互组件

TechCard 技术栈卡片

源码:

<TechCard
  techList={[
    { category: '框架', tech: 'Next.js' },
    { category: '样式', tech: 'Tailwind CSS' },
    { category: '内容', tech: 'MDX' },
  ]}
/>

效果:

项目技术

框架
Next.js
样式
Tailwind CSS
内容
MDX

Table 数据表格

源码:

<Table
  data={{
    headers: ['字段', '类型', '必填'],
    rows: [
      ['title', 'string', '是'],
      ['image', 'string', '否'],
      ['category', 'string', '是'],
    ],
  }}
/>

效果:

字段类型必填
titlestring是
imagestring否
categorystring是

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 写法,方便每次调整后人工复查。当前页面正常,不代表所有内容和浏览器组合都已验证;遇到新问题时,可以补一个小示例来复现。

脚注

  1. 这是第一个脚注的内容。 ↩

  2. 这是第二个脚注的内容。 ↩

评论

还没有评论,来说点什么吧。

0%
  • 标题
  • 一级标题 H1
  • 二级标题 H2
  • 三级标题 H3
  • 四级标题 H4
  • 五级标题 H5
  • 六级标题 H6
  • 段落与中英混排
  • 文本样式
  • HTML 内联元素
  • 转义、实体与表达式
  • 链接
  • 列表与任务
  • 引用
  • 代码块
  • 单行 Bash 命令
  • JavaScript 与中文注释
  • Python 缩进
  • Shell 多行命令
  • PowerShell
  • HTML 标签与属性
  • JSON 数据
  • YAML 配置
  • TOML 配置
  • INI 配置
  • Diff 差异
  • 普通输出与无语言代码块
  • 超长行与横向滚动
  • 表格
  • 图片
  • 分隔线
  • 脚注
  • 折叠内容
  • 自定义组件
  • Callout 提示框
  • ProsCard 与 ConsCard
  • TechCard 技术栈卡片
  • Table 数据表格
  • ImageTabs 图片切换
  • 检查清单