排版样例:写作时能用什么

这篇是一份排版对照表,不是教程。写作时拿不准某个元素长什么样,回来看一眼。

行内元素#

普通段落。加粗、斜体、行内代码、站内链接、外部链接(外部链接会自动加 rel="noopener" 并在新标签打开)。

引用块用衬线斜体,左侧一根朱砂竖线。

适合放定义、结论,或者从别处摘来的原话。第二段会和第一段保持一点间距。

列表#

无序列表:

  • 第一项,短一点
  • 第二项,稍微写长一些,用来观察换行后的行距是否还舒服
  • 第三项
    • 嵌套一层,缩进由 padding-left 控制
    • 再一条

有序列表:

  1. 先确认目标
  2. 再拆步骤
  3. 最后验证结果——做完不等于做对,验证要单独算一步

代码#

行内的 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/ 下,用绝对路径引用,构建时会一起同步:

![说明文字](/assets/img/example.png)

分割线与结尾#


分割线在正文里是一根居中的短横,用来做场景切换。

写到这里,元素基本齐了。以后加新语法(脚注、数学公式之类),先在这里补一条,再拿去正式文章里用。