主题自带的列表样式,大多是给每个 li 前面加个小圆点就完了。写教程类文章时,这种列表既没有层次,也看不出「先做什么、后做什么」。

下面这套样式把无序列表做成一条流程时间轴:米色卡片、金色圆点、竖线串起来、01/02 自动编号、末节点实心收尾。整篇复制进自定义 CSS 就能用,不依赖任何 JS。

整套样式由五个 CSS 变量驱动,换配色只要改这五行。


一、先看它长什么样

  • 一个卡片包住整组列表,左侧留 46px 给圆点和竖线
  • 每项自动编号 01、02…,编号用 CSS 计数器生成,不用手工写
  • 圆点是 11px 金边空心圆,末项变实心深棕,作为「到此为止」的收尾
  • 竖线由每个 li::after 分段绘制,末项不画,天然不拖尾巴
  • 嵌套子列表自动降级为 24px 缩进 + 7px 金色小圆点,不套卡片、不编号

改配色只需要动 --mf-card / --mf-line / --mf-axis / --mf-gold / --mf-brown 这五个值,卡片、圆点、竖线、编号会一起变,不会出现「圆点和卡片底色对不上」的问题——因为圆点中间的镂空用的就是 --mf-card。


二、骨架:一次性粘进去

把下面这段加到主题的自定义 CSS 里(Sugar / Butterfly 一般是 custom.css,hexoblog 系可以放在 source/css/_custom.styl 对应的 css 文件,或者直接写进 style.css 末尾)。

注意一处:下面所有选择器都以 #article-container.post-content.post-content 开头。#article-container 是文章容器的 ID,.post-content 写两遍是为了提高特异性——这样不用 !important 就能压过主题自带的 #article-container ul>li::before 圆点规则。如果你的正文容器类名不叫 post-content,换成你自己主题里的那个类名即可(比如 post-body、article-content)。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
/* ============================================================
* 流程时间轴列表 —— 骨架
* 变量在 :root,换配色只改这五行(见第三节)
* ============================================================ */
:root {
--mf-card: #FBFAF7; /* 卡片底 / 圆点镂空填充 */
--mf-line: #DDD6CC; /* 卡片描边 */
--mf-axis: #C4B096; /* 竖线 */
--mf-gold: #A78C63; /* 圆点描边 */
--mf-brown: #6E4F2F; /* 编号 / 末节点实心 */

/* 几何量:圆点 11px、圆心距 li 顶部 22.5px,与编号基线共线 */
--mf-dot-left: -26px;
--mf-dot-top: 15px;
--mf-dot-size: 11px;
--mf-axis-left: -19px;
--mf-axis-top: 22.5px;

/* 嵌套子列表的小圆点 */
--mf-subdot: 7px;
--mf-subdot-ring: 3px;
--mf-subdot-blur: 7px;
--mf-subdot-halo: rgba(167, 140, 99, 0.24);
--mf-subdot-glow: rgba(167, 140, 99, 0.38);
}

/* ---------- 卡片外壳 ---------- */
#article-container.post-content.post-content ul:not(li ul) {
position: relative;
counter-reset: mflow;
display: block;
box-sizing: border-box;
margin: 24px 0;
padding: 16px 20px 16px 46px;
list-style: none;
background: var(--mf-card);
border: 1px solid var(--mf-line);
border-radius: 12px;
}

/* ---------- 列表项 ---------- */
#article-container.post-content.post-content ul:not(li ul) > li:not(.tab) {
counter-increment: mflow;
position: relative;
display: list-item;
box-sizing: border-box;
margin: 0;
padding: 8px 0;
line-height: 1.7;
text-align: left;
list-style-position: inside;
}

/* ---------- 01/02 编号:用 ::marker,不占用 ::before 和 ::after ---------- */
#article-container.post-content.post-content ul:not(li ul) > li:not(.tab)::marker {
content: counter(mflow, decimal-leading-zero) " ";
font-family: Consolas, "SFMono-Regular", monospace;
font-size: 1.125em;
font-weight: 600;
line-height: 1;
color: var(--mf-brown);
}

/* ---------- 竖线:每项一段,末项不画 ---------- */
#article-container.post-content.post-content ul:not(li ul) > li:not(.tab)::after {
content: "";
position: absolute;
left: var(--mf-axis-left);
top: var(--mf-axis-top);
bottom: calc(0px - var(--mf-axis-top));
width: 1px;
background: var(--mf-axis);
z-index: 1;
}
#article-container.post-content.post-content ul:not(li ul) > li:not(.tab):last-child::after {
display: none;
}

/* ---------- 圆点 ---------- */
#article-container.post-content.post-content ul:not(li ul) > li:not(.tab)::before {
content: "";
display: block;
position: absolute;
/* padding/margin 必须归零:部分主题在 ≤767px 给 li::before 加了左右 padding,
* 不写会把 11px 的圆点横向撑成椭圆 */
padding: 0;
margin: 0;
left: var(--mf-dot-left);
top: var(--mf-dot-top);
box-sizing: content-box;
width: var(--mf-dot-size);
height: var(--mf-dot-size);
border: 2px solid var(--mf-gold);
border-radius: 50%;
background: var(--mf-card);
box-shadow: none;
z-index: 2;
}
#article-container.post-content.post-content ul:not(li ul) > li:not(.tab):last-child::before {
background: var(--mf-brown);
border-color: var(--mf-brown);
}

/* ---------- 嵌套子列表:只要小圆点,不套卡片 ---------- */
#article-container.post-content.post-content li ul {
display: block;
box-sizing: border-box;
margin: 6px 0 2px;
padding: 2px 0 2px 24px;
list-style: none;
background: none;
border: 0;
border-radius: 0;
counter-reset: none;
}
#article-container.post-content.post-content li ul > li:not(.tab) {
display: block;
position: relative;
box-sizing: border-box;
margin: 0;
padding: 3px 0 3px 16px;
line-height: 1.7;
list-style: none;
counter-increment: none;
}
#article-container.post-content.post-content li ul > li:not(.tab)::before {
content: "";
display: block;
position: absolute;
padding: 0;
margin: 0;
left: calc(4.5px - var(--mf-subdot) / 2);
top: calc(16.5px - var(--mf-subdot) / 2);
box-sizing: content-box;
width: var(--mf-subdot);
height: var(--mf-subdot);
border: 0;
border-radius: 50%;
background: var(--mf-gold);
box-shadow:
0 0 0 var(--mf-subdot-ring) var(--mf-subdot-halo),
0 0 var(--mf-subdot-blur) 1px var(--mf-subdot-glow);
}
#article-container.post-content.post-content li ul > li:not(.tab)::after {
content: none;
}

/* ---------- 松散列表:项里被 <p> 包住时,别把编号挤到上一行 ---------- */
#article-container.post-content.post-content ul:not(li ul) > li:not(.tab) > p:first-child {
display: inline;
margin-top: 0;
line-height: inherit;
}
#article-container.post-content.post-content ul:not(li ul) > li:not(.tab) > p:last-child {
margin-bottom: 0;
}

/* ---------- 移动端 ---------- */
@media (max-width: 640px) {
#article-container.post-content.post-content ul:not(li ul) {
padding: 14px 15px 14px 41px;
}
#article-container.post-content.post-content li ul {
padding-left: 16px;
}
}

粘完之后,正文里正常的 - 列表 就会变成时间轴。


三、七种配色:替换 :root 里那五行

每种配色都给明暗两套。把第二节 :root 里的五个 --mf-* 换掉(深色模式需要额外加 :root[data-theme="dark"] 那一段)。

① 暖棕(默认)

最低调的一套,和大多数米白底的主题最贴。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
:root {
--mf-card: #FBFAF7;
--mf-line: #DDD6CC;
--mf-axis: #C4B096;
--mf-gold: #A78C63;
--mf-brown: #6E4F2F;
}
:root[data-theme="dark"] {
--mf-card: #242424;
--mf-line: #3A3A3A;
--mf-axis: #6B5942;
--mf-gold: #B9925F;
--mf-brown: #D7A46B;
}

② 青瓷绿

偏青的淡绿,和暖棕相差 90° 以上,区分最明显,适合想让列表跳出来一点的站点。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
:root {
--mf-card: #ECF3E9;
--mf-line: #D5E2D1;
--mf-axis: #B4C6B3;
--mf-gold: #7E9A7C;
--mf-brown: #43604A;
}
:root[data-theme="dark"] {
--mf-card: #212823;
--mf-line: #354036;
--mf-axis: #5B705C;
--mf-gold: #8FAE8B;
--mf-brown: #A9C9A3;
}

③ 苔绿

偏黄绿的橄榄调,和米色是邻近色,观感像旧纸,最耐看。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
:root {
--mf-card: #F2F3E7;
--mf-line: #DFE1CE;
--mf-axis: #C3C6A5;
--mf-gold: #8F9570;
--mf-brown: #4E5538;
}
:root[data-theme="dark"] {
--mf-card: #252718;
--mf-line: #3A3C2A;
--mf-axis: #5F6446;
--mf-gold: #9AA173;
--mf-brown: #C2C99A;
}

④ 雾霭蓝

冷蓝灰,和代码块的靛蓝同一色系,技术类博客最稳。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
:root {
--mf-card: #EAF1F8;
--mf-line: #D2E0EE;
--mf-axis: #B2C4D8;
--mf-gold: #7191B4;
--mf-brown: #3B5674;
}
:root[data-theme="dark"] {
--mf-card: #212830;
--mf-line: #33404F;
--mf-axis: #5A7189;
--mf-gold: #8FAFD2;
--mf-brown: #A8C6E4;
}

⑤ 藕荷紫

低饱和的灰紫,安静的文艺感;存在感偏弱,适合文字为主、插图不多的站点。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
:root {
--mf-card: #F2ECF4;
--mf-line: #DFD2E4;
--mf-axis: #C6B3CD;
--mf-gold: #96789E;
--mf-brown: #5A4263;
}
:root[data-theme="dark"] {
--mf-card: #262129;
--mf-line: #3B3441;
--mf-axis: #6E5D78;
--mf-gold: #B296BC;
--mf-brown: #C6A9D0;
}

⑥ 石墨灰

几乎没有色相,最中性。好处是和任何主题色都不打架,坏处是也不容易让人注意到。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
:root {
--mf-card: #EEF1F3;
--mf-line: #D8DEE2;
--mf-axis: #BCC3C9;
--mf-gold: #78848F;
--mf-brown: #3C4750;
}
:root[data-theme="dark"] {
--mf-card: #23262A;
--mf-line: #343A40;
--mf-axis: #5A646E;
--mf-gold: #94A0AB;
--mf-brown: #B6C0C9;
}

⑦ 陶土棕

比默认暖棕更偏红一点,暖色调站点里最协调;但和默认色太近,等于没换。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
:root {
--mf-card: #F9EFE8;
--mf-line: #E9D5C8;
--mf-axis: #D2B3A2;
--mf-gold: #B07C62;
--mf-brown: #6B4433;
}
:root[data-theme="dark"] {
--mf-card: #2A2320;
--mf-line: #413430;
--mf-axis: #7A5B4B;
--mf-gold: #C99479;
--mf-brown: #E0B49D;
}

配色速查:

配色 卡片底 圆点 编号 适合
暖棕 #FBFAF7 #A78C63 #6E4F2F 米白底、纸感站点
青瓷绿 #ECF3E9 #7E9A7C #43604A 想让列表跳出来
苔绿 #F2F3E7 #8F9570 #4E5538 暖色主题、最耐看
雾霭蓝 #EAF1F8 #7191B4 #3B5674 技术类、代码多
藕荷紫 #F2ECF4 #96789E #5A4263 文艺、文字为主
石墨灰 #EEF1F3 #78848F #3C4750 极简、无色相
陶土棕 #F9EFE8 #B07C62 #6B4433 暖色、同族

四、让有序列表和无序列表用不同颜色

同一篇文章里,无序列表是「并列的要点」,有序列表是「有先后的步骤」。它们骨架相同,靠颜色就能分开——读者扫一眼就知道这一段该「并列读」还是「按顺序做」。

做法很简单:在 ol 上重新定义一遍那五个变量,其余规则完全复用。变量定义在 ol 上而不是 :root,好处是 ol 里面嵌套的子列表会自动继承同一套色,而 ul 里的子列表仍然是 ul 的颜色,层级不会串。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
/* 有序列表换成苔绿,结构一行不动 */
#article-container.post-content.post-content ol:not(li ol) {
--mf-card: #F2F3E7;
--mf-line: #DFE1CE;
--mf-axis: #C3C6A5;
--mf-gold: #8F9570;
--mf-brown: #4E5538;
}
:root[data-theme="dark"] #article-container.post-content.post-content ol:not(li ol) {
--mf-card: #252718;
--mf-line: #3A3C2A;
--mf-axis: #5F6446;
--mf-gold: #9AA173;
--mf-brown: #C2C99A;
}

然后给 ol 补上和 ul 完全一样的那套规则——把第二节里所有 ul:not(li ul) 替换成 ol:not(li ol)、counter-reset: mflow 换成 counter-reset: mfol、counter(mflow, …) 换成 counter(mfol, …),复制一份贴上去即可。骨架完全共用,只是变量不同,所以两套列表的结构、间距、对齐都不会有偏差。

只改颜色、不套骨架是不行的:ol 会变成一块只有底色、没有圆点和编号的空白卡片。要么整套复制,要么就别动——这也是为什么上面强调「结构一行不改」。变量定义在 ol 上还有个附带好处:ol 里嵌套的子列表会自动跟着变绿,而 ul 里的子列表仍然是暖棕,一个页面里放几种列表也不会串色。


五、暗色模式

上面每套配色都带了 :root[data-theme="dark"] 一段。如果你主题切换暗色用的不是 data-theme 属性,而是 class(比如 .dark)或 prefers-color-scheme,把选择器换掉就行:

1
2
3
4
5
6
7
/* class 方案 */
.dark { --mf-card: #242424; /* ... */ }

/* 跟随系统 */
@media (prefers-color-scheme: dark) {
:root { --mf-card: #242424; /* ... */ }
}

暗色下要注意两点:卡片底不要比页面背景更暗,否则会变成一个「洞」;圆点和编号要提亮,否则在深底上糊成一团。上面给的深色值都是按这个原则调的。


六、适配你的主题

几个常见问题:

1. 圆点没出来,或者变成了竖条

主题里通常有 #article-container ul > li::before 这样的规则在画小圆点。它没有设 position,而 li 有行高,于是伪元素被拉成一条竖线。解决办法就是本文的写法:给 ::before 显式 position: absolute + 固定宽高,并且把选择器特异性提高到压过它。#article-container.post-content.post-content 这个写法就是干这个用的,全程不需要 !important。

2. 编号不见了

多半是主题的全局重置里有 li, ul { list-style: none; display: block }。list-style: none 是可继承属性,会把 ::marker 一起干掉。所以列表项必须显式写回 display: list-item + list-style-position: inside。

3. 手机上圆点变成椭圆

有些主题(比如 Sugar)在 @media (max-width: 767px) 里给 ol > li::before 加了 padding: 0 6px。你的规则如果只设了 width/height 没设 padding,圆点就会被横向撑成 23×11 的椭圆。骨架里的 padding: 0; margin: 0; 就是防这个的。

4. 项和项之间空得太大

Markdown 在列表项之间留空行时,会把内容包进 <p>,而主题给 p 的上下 margin 很大。骨架最后那段 p:first-child { display: inline } 就是解决这个的——它让编号和文字待在同一行,而不是编号孤零零挂在上面一行。

5. 只想用在某几篇文章

给文章容器加个类,把选择器前缀从 #article-container 换成 .timeline,然后在 Markdown 里用 <div class="timeline"> 包住列表即可。


七、写在最后

这套样式没有任何 JS,全部靠 CSS 的计数器和伪元素:

  • ::marker 负责编号(不占用 ::before / ::after)
  • ::before 负责圆点
  • ::after 负责竖线

三个伪元素各管一件事,互不打架,这也是为什么圆点、编号、竖线能精确对齐到同一个基线。

配色部分之所以只用五个变量,是为了让「换色」变成一件不会出错的事——你不需要逐条去找哪些地方写了颜色,改 :root 就够。