写技术笔记常用的 Markdown 语法封面
发布于

写技术笔记常用的 Markdown 语法

一份可以直接复制使用的 Markdown 写作速查表。

完整教程入门写作工程Markdown技术写作

Markdown 的目标是让我们专注内容,而不是排版按钮。下面是技术博客最常用的几种写法。

标题层级

# 文章标题
## 主要章节
### 章节中的小节

一篇文章通常只有一个一级标题;在 Astro 博客中,一级标题已经来自文章的 title,正文可以从二级标题开始。

列表

- 无序项目
- 另一个项目

1. 第一步
2. 第二步

链接、强调和引用

[Astro 官方文档](https://docs.astro.build/)

**重点内容**`行内代码`

> 这是一段需要突出显示的引用。

代码块

在三个反引号后写明语言,通常可以得到更准确的语法高亮:

const message = '你好,Astro!';
console.log(message);

推荐的文章结构

  1. 先说明遇到了什么问题。
  2. 给出最终可用的解决办法。
  3. 解释关键步骤为什么有效。
  4. 记录踩过的坑和验证方法。

结构清楚比使用复杂语法更重要。