往心里去

Markdown 写法速查

#写作#Markdown

这篇文章把所有能用到的 Markdown 语法写了一遍。以后写新文章时，可以直接复制这里的片段改。

文本

普通段落直接写就行。加粗用两个星号，斜体用一个星号，删除线用两个波浪线。行内代码用反引号，比如 npm run build。

需要放链接时写 [显示的文字](https://example.com)，效果是 这样一个链接。

引用块用大于号开头。

适合放一段别人的话，或者需要强调的结论。

列表

无序列表：

  • 第一项
  • 第二项
    • 嵌套的项要缩进两个空格
    • 另一条嵌套项

有序列表：

  1. 先把事情想清楚
  2. 再动手写代码
  3. 最后回头补文档

代码

行内代码已经在上面出现过了。代码块指定语言就会自动高亮：

// 计算两个日期之间隔了多少天
function daysBetween(a, b) {
	const oneDay = 24 * 60 * 60 * 1000;
	return Math.round(Math.abs((a - b) / oneDay));
}
# 本地预览
npm run dev

# 构建成静态文件，产物在 dist/ 目录
npm run build
def fib(n: int) -> int:
    """返回第 n 个斐波那契数"""
    a, b = 0, 1
    for _ in range(n):
        a, b = b, a + b
    return a

如果要写的内容里本身包含三反引号（比如在讲 Markdown 语法），用四个反引号把代码块包起来：

```js
console.log('这样里面就能安全地写三反引号了');
```

表格

语法 作用 示例
**文字** 加粗 重点
*文字* 斜体 强调
`代码` 行内代码 npm install
> 文字 引用块 见上文

分隔线

单独一行写三个减号：

分隔线适合用在两个话题之间，切换语气。

图片

图片放在 src/content/posts/ 目录下，用相对路径引用：

![图片说明](./example.png)

图片说明（方括号里的字）不要省，它是给看不到图的人读的。

小结

常用的就这些。Markdown 的好处是写作时不用管排版，专注于把话讲清楚 —— 格式的事情交给样式表。