← 所有文章

Markdown 写法速查:这个博客支持哪些排版

标题、列表、代码块、表格、引用、脚注……写文章时可以直接照抄的示例。

这篇文章既是写法速查,也是排版效果的演示。写新文章时可以直接复制需要的片段。

文字样式

普通文字可以包含 加粗、斜体、删除线 和 行内代码。链接像这样写:Astro 官网。键盘按键可以用 Ctrl + K 表示。

列表

无序列表:

  • 第一项
  • 第二项
    • 嵌套的子项
    • 另一个子项
  • 第三项

有序列表:

  1. 先做这个
  2. 再做那个
  3. 最后检查一遍

任务列表:

  • 搭好博客
  • 写第一篇文章
  • 绑定自己的域名

引用

好的排版是看不见的,它只是让文字更容易被读完。

代码

行内用反引号,多行用三个反引号加语言名,会自动高亮并随深浅色主题切换:

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/,然后这样引用:

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

脚注

脚注适合放补充说明1,不会打断正文的阅读节奏。


以上就是常用的写法。

Footnotes

  1. 像这样,脚注内容会自动排到文章末尾。 ↩

评论