MMorroa
返回博客

Markdown 写作完全指南

掌握 Markdown 常用语法,写出结构清晰、阅读体验良好的文章。

Morroa2026年9月10日1 分钟更新于 2026年9月12日

Markdown 的初衷,是让你专注于内容,而不是排版。下面这份指南覆盖了博客中最常用的语法。

标题与段落

使用 # 表示标题层级。正文段落之间保留一个空行。

md
## 二级标题

这是一个普通段落。

### 三级标题

这是另一个段落。

列表

无序列表适合罗列要点,有序列表适合描述步骤。

  • 第一项
  • 第二项
    • 嵌套项
  • 第三项
  1. 第一步
  2. 第二步
  3. 第三步

任务列表

  • 完成初稿
  • 补充代码示例
  • 发布文章

代码块

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

ts
export function hello(name: string) {
  return `Hello, ${name}!`;
}

行内代码使用反引号,例如 process.env.NODE_ENV

表格

功能是否支持
表格
代码高亮
任务列表

引用与链接

好的工具应该让创作更简单,而不是增加负担。

链接写作 [文字](https://example.com),图片写作 ![描述](图片地址)

分隔线

使用三个或更多短横线可以创建分隔线:


现在,你已经可以开始写作了。

评论

评论功能默认关闭。你可以在部署时配置 Giscus 环境变量:NEXT_PUBLIC_GISCUS_REPO等参数后启用。
文章 slug:markdown-guide

Related

相关文章

第一篇文章

第一篇文章

欢迎来到我的博客,从这里开始记录学习、实践与成长。

3 分钟
你好,Morroa

你好,Morroa

欢迎来到这个由 Markdown 驱动的静态博客。

1 分钟
把 Next.js 博客部署到 GitHub Pages 和 Vercel

把 Next.js 博客部署到 GitHub Pages 和 Vercel

一份面向静态博客的部署清单:静态导出、环境变量、自定义域名与自动化发布。

1 分钟