Markdown 写作速查

写文章只需要记住很少几个符号。下面这段把常用的语法和它的渲染结果放在一起，忘了的时候回来翻一眼。

行内格式

标题

用 # 到 #### 表示四级标题。正文里建议只用 ## 和 ###，因为 ## 会自动出现在右侧目录中，一级标题留给文章名。

列表

无序列表：

• 一台服务器
• 一个域名
• 一点想说的话

有序列表：

1. 安装 Hugo
2. 写 Markdown
3. 构建发布

引用

写作是把混乱的思绪，整理成别人也能读懂的顺序。

—— 这句话是我编的，但道理不假。

代码

行内：hugo --minify 会顺带压缩 HTML 和 CSS。

代码块（支持语法高亮）：

def word_count(text: str) -> int:
    """统计中文字符与英文单词的总数。"""
    cjk = sum(1 for ch in text if "\u4e00" <= ch <= "\u9fff")
    words = len([w for w in text.split() if w.isascii()])
    return cjk + words

# 本地预览，带草稿
hugo server -D --bind 0.0.0.0 --port 1313

图片

![替代文字](/images/photo.jpg)

图片放在 static/images/ 目录下，构建时会原样复制。建议宽度控制在 1600px 以内，用 WebP 能省一半流量。

分割线

三个以上的 - 单独成行：

脚注

正文里标注一个引用¹，页面底部会自动生成脚注列表。

小提示

• 段落之间空一行才会被识别成两个段落。
• 一行结尾加两个空格表示换行，也可以直接用空行分段。
• description 字段会用在列表页和社交分享卡片上，值得花十秒钟写好。