用 Markdown 写作：语法速查与排版建议

基础语法

## 二级标题（文章主要章节）
### 三级标题
#### 四级标题

- 无序项
- 无序项
  - 嵌套项

1. 有序项
2. 有序项

[链接文字](https://example.com)
![图片说明](/images/photo.webp)

代码块

指定语言可以获得语法高亮：

```typescript
interface Post {
  title: string;
  published: Date;
  tags: string[];
}

function formatDate(date: Date): string {
  return date.toISOString().slice(0, 10);
}
```

渲染效果：

interface Post {
  title: string;
  published: Date;
  tags: string[];
}

function formatDate(date: Date): string {
  return date.toISOString().slice(0, 10);
}

深色模式下代码块会自动切换到对应的暗色主题，无需额外配置。

引用与提示

> 这是一段引用。
> 可以跨多行。

这是一段引用。 可以跨多行。

如果需要更强的视觉区分，可以用加粗开头：

注意 某些情况下，构建缓存可能导致样式未更新，此时删除 .astro 目录后重新构建即可。

表格

| 参数 | 类型 | 默认值 |
| --- | --- | --- |
| `pageSize` | number | `8` |
| `sortBy` | string | `date` |

数学公式

行内公式用单个美元符号包裹，例如 $O(n \log n)$。

独立公式用两个美元符号：

公式依赖 KaTeX 渲染，在构建期就已转成 HTML，浏览器无需加载数学库。

分隔线

三个短横线独占一行：

---

排版建议

几条实践下来的心得：

1. 中英文之间加空格。视觉上更透气，例如「使用 Astro 构建」而不是「使用Astro构建」。
2. 段落不要过长。中文段落控制在 3 到 5 行，移动端阅读体验更好。
3. 代码块标注语言。既为了高亮，也为了语义清晰。
4. 图片补 alt 文本。这是无障碍要求，也影响 SEO。
5. 标题有信息量。避免「其他」「补充」这类无意义的标题。

一份可复制的骨架

---
title: 文章标题
published: 2026-09-15
description: 一句话概括文章内容
image: images/cover.png
tags: ["标签一", "标签二"]
category: 技术
draft: false
---

开篇段落，说明这篇文章解决什么问题。

## 第一节

正文内容。

## 第二节

正文内容。

## 小结

总结要点。

把这段贴在新建的 Markdown 文件顶部，替换掉具体内容，就可以开始写了。