Markdown 写法速查:这个博客支持哪些排版
标题、列表、代码块、表格、引用、脚注……写文章时可以直接照抄的示例。
这篇文章既是写法速查,也是排版效果的演示。写新文章时可以直接复制需要的片段。
文字样式
普通文字可以包含 加粗、斜体、删除线 和 行内代码。链接像这样写:Astro 官网。键盘按键可以用 Ctrl + K 表示。
列表
无序列表:
- 第一项
- 第二项
- 嵌套的子项
- 另一个子项
- 第三项
有序列表:
- 先做这个
- 再做那个
- 最后检查一遍
任务列表:
- 搭好博客
- 写第一篇文章
- 绑定自己的域名
引用
好的排版是看不见的,它只是让文字更容易被读完。
代码
行内用反引号,多行用三个反引号加语言名,会自动高亮并随深浅色主题切换:
interface Post {
title: string;
date: Date;
tags: string[];
}
export function latest(posts: Post[], n = 5): Post[] {
return [...posts].sort((a, b) => b.date.valueOf() - a.date.valueOf()).slice(0, n);
}
npm run dev # 本地预览
npm run build # 构建并生成搜索索引
表格
| 命令 | 作用 | 备注 |
|---|---|---|
npm run dev |
启动本地开发服务器 | 能看到草稿 |
npm run build |
构建生产版本 | 草稿不会被构建 |
npm run preview |
预览构建结果 | 搜索只在这里可用 |
图片
把图片放进 public/images/,然后这样引用:

脚注
脚注适合放补充说明1,不会打断正文的阅读节奏。
以上就是常用的写法。
Footnotes
-
像这样,脚注内容会自动排到文章末尾。 ↩
评论