教程 2026 年 8 月 29 日 # 教程 # Markdown

本站支持的 Markdown 语法

本站基于 Astro + Sätteri 渲染 Markdown,本文实测整理出全部已支持的语法,附示例。

本文基于本站实际渲染管线(Astro 7 + Sätteri)逐项实测整理,保证下面的语法都能正常显示。

1. 标题

# 到 ###### 一共六级标题,渲染后自动带锚点 id,点目录可以跳转。

2. 强调

  • 粗体:**粗体**
  • 斜体:*斜体*
  • 删除线:~~删除线~~
  • 行内代码:`行内代码`

3. 引用

这是一段引用 支持多行

> 开头即可,渲染成 blockquote。

4. 列表

无序列表:

  • 苹果
  • 香蕉
  • 西瓜

有序列表:

  1. 第一步
  2. 第二步
  3. 第三步

任务列表(GFM):

  • 已完成
  • 未完成

5. 链接与图片

链接:mccsjs

图片(支持懒加载,鼠标悬停卡片会缩放):

示例图片

6. 表格

语法说明
表格GFM 语法,自动生成表头
代码块Shiki 双主题高亮
脚注文末自动生成注记

7. 代码块

带语言标识的代码块用 Shiki 高亮,浅色/深色主题自动切换(github-light / github-dark):

// JavaScript
const greet = (name) => `Hello, ${name}!`;
console.log(greet('世界'));
# Shell
git add .
git commit -m "更新文章"
git push origin main
{
  "name": "mccsjsblog",
  "astro": "^7.2.9"
}

不写语言也行,照样渲染:

纯文本代码块

8. 脚注

本站支持脚注1,引用处自动生成上标,文末自动生成注记区。

9. 分隔线与 Emoji


本站文章里可以放心使用 Emoji:🍭 🐦 🥝 ✨

10. 内联 HTML

文章渲染默认放行内联 HTML,因此可以做出一些普通 Markdown 做不到的效果,比如文字颜色:

  • 红色文字
  • 橙色文字
  • 青绿文字

也可以直接写 <blockquote>、<center> 之类的标签做排版。

11. 文章 frontmatter 字段

每篇文章开头用 --- 包裹的元信息,本站支持以下字段:

字段含义必填
title文章标题是
slug链接后缀,8 位 hex是
date发布时间是
fl分类是
tags标签是
zy摘要(首页卡片显示)否
fm封面图否
zz作者否
cg草稿标记否

示例:

---
title: "本站支持的 Markdown 语法"
slug: "19e11c07"
date: "2026-08-29 10:55:00"
fl: "教程"
tags: ["教程", "Markdown"]
---

12. 其他说明

  • 本站使用 Astro 7 + Sätteri 渲染管线,默认开启 GFM(表格、删除线、任务列表、自动链接)
  • 代码高亮用 Shiki,双主题跟随站点浅色/深色切换
  • 分类与标签会自动聚合到归档与标签页,无需手动维护

以上就是本站全部已支持的 Markdown 语法,写文章时按需使用即可。

Footnotes

  1. 这就是脚注内容,点击上标可以跳到这里。 ↩

评论

评论加载中…