排版样例:写作时能用什么
这篇是一份排版对照表,不是教程。写作时拿不准某个元素长什么样,回来看一眼。
行内元素#
普通段落。加粗、斜体、行内代码、站内链接、外部链接(外部链接会自动加 rel="noopener" 并在新标签打开)。
引用块用衬线斜体,左侧一根朱砂竖线。
适合放定义、结论,或者从别处摘来的原话。第二段会和第一段保持一点间距。
列表#
无序列表:
- 第一项,短一点
- 第二项,稍微写长一些,用来观察换行后的行距是否还舒服
- 第三项
- 嵌套一层,缩进由
padding-left控制 - 再一条
- 嵌套一层,缩进由
有序列表:
- 先确认目标
- 再拆步骤
- 最后验证结果——做完不等于做对,验证要单独算一步
代码#
行内的 ss -lntp 长这样。块级代码带语言标签和复制按钮,语言名写在围栏后面:
from pathlib import Path
def files_under(root: Path) -> int:
"""统计目录下的文件数。"""
return sum(1 for p in root.rglob("*") if p.is_file())
print(files_under(Path("dist")))
# 查看 nginx 实际监听的端口与进程
ss -lntp | grep -E ":80 |:443 "
# 语法检查后平滑重载
nginx -t && nginx -s reload
没有标语言的代码块会按纯文本渲染:
这是一段没有语言标记的文本块
保留了缩进
表格#
| 元素 | 写法 | 用途 |
|---|---|---|
| 标题 | 行首 ## |
会自动进右侧目录(3 个以上才显示) |
| 表格 | 竖线分隔 | 参数、对照、清单 |
| 引用 | 行首 > |
结论或摘录 |
| 分割线 | 单独一行 --- |
段落切换 |
图片#
图片放在 static/img/ 下,用绝对路径引用,构建时会一起同步:

分割线与结尾#
分割线在正文里是一根居中的短横,用来做场景切换。
写到这里,元素基本齐了。以后加新语法(脚注、数学公式之类),先在这里补一条,再拿去正式文章里用。