标题示例

第19、20行markdownlint-capture、markdownlint-disable代码，以及第36行markdownlint-restore代码，共同组合使用，表示第21-31行的规则全部关闭。

一级标题

mt-4 .mb-0表示的效果为：一级标题上方留出约 1rem 间距，下方不留间距。‌‌ 网页设计里的rem是CSS样式单位，用来设置字体或元素尺寸，和根元素大小挂钩。

二级标题

data-toc-skip=‘‘表示一个‌HTML自定义属性‌，告诉TOC生成脚本“跳过这个二级标题，不要把它放进目录里”。 它本身是空的，只要存在这个属性就生效，不需要赋值。‌‌

三级标题

四级标题

该行代码和第19、20行代码组合使用。

段落

第一段。这一行可以一直写，都属于第一段。网页会自动换行。

第二段。段与段之间需隔一行空行，表示下一段内容。否则还是属于同一段。

列表

编号列表

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

多级编号

• 第一章
  • 第一节
    • 第一段

待办清单

• 待办
  • 第一步
  • 第二步
  • 第三步

注释

太阳

地球绕其运行的恒星。

月亮

地球的天然卫星，通过太阳反射光可见。

引用

这条线显示了 块状引文。

提示

表格

网址

排版示范md文件源代码官方示例：https://github.com/cotes2020/jekyll-theme-chirpy/blob/master/_posts/2019-08-08-text-and-typography.md?plain=1

对应的官方排版示范文本与效果：https://chirpy.cotes.page/posts/text-and-typography/#headings

脚注

点击可以跳转到脚注¹，这是另一个脚注²。

代码高亮

这是一段突出显示的 高亮代码。

文件路径

这是 /path/to/the/file.extend.

代码块（有复制按钮，方便读者复制）

纯文本代码

1

这是一段常见的代码片段，没有语法高亮和行号。

特定编程语言

1
2
3
4

if [ $? -ne 0 ]; then
  echo "程序运行失败。";
  #do the needful / exit
fi;

特定文件名

1
2
3

@import
  "colors/light-typography",
  "colors/dark-typography";

数学

该数学公式由 MathJax生成:

我们可以将该方程引用为 \eqref{eq:series}.

当 $a \ne 0$, 则有两个解 $ax^2 + bx + c = 0$ 具体为

$x = {-b \pm \sqrt{b^2-4ac} \over 2a}$

Mermaid SVG 一种基于文本的图表描述语言

gantt
  title  为中国科技添加甘特图功能
  kirin :a, 2026-12-20, 1w
  ADS :crit, b, 2026-12-23, 1d
  deepseek :active, c, after b a, 1d

gantt
  title  为中国科技添加甘特图功能
  kirin :a, 2026-12-20, 1w
  ADS :crit, b, 2026-12-23, 1d
  deepseek :active, c, after b a, 1d

gantt
  title  为中国科技添加甘特图功能
  kirin :a, 2026-12-20, 1w
  ADS :crit, b, 2026-12-23, 1d
  deepseek :active, c, after b a, 1d

1
2
3
4
5

gantt
  title  为中国科技添加甘特图功能
  kirin :a, 2026-12-20, 1w
  ADS :crit, b, 2026-12-23, 1d
  deepseek :active, c, after b a, 1d

图片

默认 (附说明)

让内容占满整个屏幕宽度，同时在页面上水平居中显示

左对齐

向左浮动

人之初，性本善。性相近，习相远。苟不教，性乃迁。教之道，贵以专。昔孟母，择邻处。子不学，断机杼。窦燕山，有义方。教五子，名俱扬。养不教，父之过。教不严，师之惰。子不学，非所宜。幼不学，老何为。玉不琢，不成器。人不学，不知义。为人子，方少时。亲师友，习礼仪。香九龄，能温席。孝于亲，所当执。融四岁，能让梨。悌于长，宜先知。首孝悌，次见闻。知某数，识某文。一而十，十而百。百而千，千而万。三才者，天地人。三光者，日月星。三纲者，君臣义。父子亲，夫妇顺。曰春夏，曰秋冬。此四时，运不穷。曰南北，曰西东。此四方，应乎中。曰水火，木金土。此五行，本乎数。十干者，甲至癸。十二支，子至亥。曰黄道，日所躔。曰赤道，当中权。赤道下，温暖极。我中华，在东北。曰江河，曰淮济。此四渎，水之纪。曰岱华，嵩恒衡。此五岳，山之名。曰士农，曰工商。此四民，国之良。

向右浮动

人之初，性本善。性相近，习相远。苟不教，性乃迁。教之道，贵以专。昔孟母，择邻处。子不学，断机杼。窦燕山，有义方。教五子，名俱扬。养不教，父之过。教不严，师之惰。子不学，非所宜。幼不学，老何为。玉不琢，不成器。人不学，不知义。为人子，方少时。亲师友，习礼仪。香九龄，能温席。孝于亲，所当执。融四岁，能让梨。悌于长，宜先知。首孝悌，次见闻。知某数，识某文。一而十，十而百。百而千，千而万。三才者，天地人。三光者，日月星。三纲者，君臣义。父子亲，夫妇顺。曰春夏，曰秋冬。此四时，运不穷。曰南北，曰西东。此四方，应乎中。曰水火，木金土。此五行，本乎数。十干者，甲至癸。十二支，子至亥。曰黄道，日所躔。曰赤道，当中权。赤道下，温暖极。我中华，在东北。曰江河，曰淮济。此四渎，水之纪。曰岱华，嵩恒衡。此五岳，山之名。曰士农，曰工商。此四民，国之良。

暗黑/明亮模式和阴影效果

下面的图片会根据主题偏好自动切换暗黑/明亮模式，并且显示阴影效果。需要自行制作两种模式的图片，这里我偷懒就随便放两张不同的图片，仅作示范。

Video

Reverse Footnote