技术

Markdown 语法完全指南:从基础到高级

Markdown 语法完全指南:从基础到高级

前言

本博客基于 Astro 构建,支持完整的 Markdown 语法和多种高级标记。本文将逐一展示所有支持的语法特性,帮助你快速上手写作。

一、基础文本格式

1.1 强调文本

  • 粗体文本:使用 **文本** 或 __文本__
  • 斜体文本:使用 *文本* 或 _文本_
  • 粗斜体:使用 ***文本***
  • 删除线:使用 ~~文本~~

1.2 文字标色

通过 HTML 内联样式可以给文字设置任意颜色:

  • 红色文字
  • 绿色文字
  • 蓝色文字
  • 橙色加粗文字
  • 渐变色文字

1.3 字号与字体调整

  • 小号文字
  • 中号文字
  • 大号加粗文字
  • 衬线字体文字
  • 等宽字体文字

二、标题层级

一级标题 H1

二级标题 H2

三级标题 H3

四级标题 H4

五级标题 H5
六级标题 H6

三、列表

3.1 无序列表

  • 苹果
  • 香蕉
    • 小米蕉
    • 帝王蕉
  • 橙子

3.2 有序列表

  1. 第一步:准备材料
  2. 第二步:混合搅拌
    1. 先加入液体
    2. 再加入粉末
  3. 第三步:烘烤成型

3.3 任务列表(GFM)

  • 完成项目初始化
  • 实现文章管理
  • 集成评论系统
  • 添加搜索功能
  • 优化移动端体验

四、引用块

这是一段引用文字。引用块可以用来强调重要观点、引用他人言论或展示注释。

引用块支持多段落,每一行前面加上 > 符号即可。

引用块也支持嵌套:

这是嵌套的第二层引用

这是第三层引用

五、代码

5.1 行内代码

在正文中使用 const hello = "world"; 来标记行内代码。

5.2 代码块

支持 190+ 编程语言的语法高亮:

// JavaScript 示例
function fibonacci(n) {
  if (n <= 1) return n;
  return fibonacci(n - 1) + fibonacci(n - 2);
}
console.log(fibonacci(10)); // 输出: 55
# Python 示例
def quicksort(arr):
    if len(arr) <= 1:
        return arr
    pivot = arr[len(arr) // 2]
    left = [x for x in arr if x < pivot]
    middle = [x for x in arr if x == pivot]
    right = [x for x in arr if x > pivot]
    return quicksort(left) + middle + quicksort(right)
// TypeScript 示例
interface User {
  id: number;
  name: string;
  email: string;
}

async function getUser(id: number): Promise<User> {
  const response = await fetch(`/api/users/${id}`);
  return response.json();
}
# Bash 命令示例
npm install
npm run dev
npm run build
SELECT u.name, u.email, COUNT(o.id) as order_count
FROM users u
LEFT JOIN orders o ON u.id = o.user_id
WHERE u.created_at >= '2026-01-01'
GROUP BY u.id, u.name, u.email
HAVING COUNT(o.id) > 5
ORDER BY order_count DESC
LIMIT 10;

六、表格(GFM)

功能支持情况说明
基础 Markdown✅标题、列表、引用等
GFM 扩展✅表格、任务列表、删除线
数学公式✅KaTeX 渲染
代码高亮✅190+ 语言
图片懒加载✅IntersectionObserver
评论系统✅GitHub 登录
左对齐居中对齐右对齐
内容1内容2内容3

七、链接与图片

所有图片自动启用懒加载,点击可放大查看:

示例图片 - 风景

八、数学公式(KaTeX)

8.1 行内公式

质能方程:E=mc2E = mc^2,勾股定理:a2+b2=c2a^2 + b^2 = c^2。

8.2 块级公式

x=−b±b2−4ac2ax = \frac{-b \pm \sqrt{b^2 - 4ac}}{2a} A=(a11a12a13a21a22a23a31a32a33)A = \begin{pmatrix} a_{11} & a_{12} & a_{13} \\ a_{21} & a_{22} & a_{23} \\ a_{31} & a_{32} & a_{33} \end{pmatrix} ∫0+∞e−x2dx=π2\int_0^{+\infty} e^{-x^2} dx = \frac{\sqrt{\pi}}{2}

九、脚注

这是一个带有脚注的句子1,脚注会在页面底部显示。

十、水平线与分隔


使用 --- 可以创建水平线。

十一、键盘按键

  • 保存:Ctrl + S
  • 复制:Ctrl + C
  • 粘贴:Ctrl + V

十二、提示框(通过 HTML 实现)

💡 提示
这是一个信息提示框,可以用来展示重要提示或注意事项。
✅ 成功
操作已成功完成!
⚠️ 警告
请注意以下事项。
❌ 错误
发生了一个错误。

总结

以上就是本博客支持的全部 Markdown 语法特性。你可以:

  1. 使用标准 Markdown 进行基础写作
  2. 通过 GFM 扩展使用表格、任务列表等
  3. 利用 KaTeX 编写数学公式
  4. 通过 HTML 内联样式定制文字颜色、字号、字体
  5. 所有图片自动懒加载,点击可放大
  6. 使用代码块展示带语法高亮的代码

开始你的写作之旅吧!

Footnotes

  1. 这是第一个脚注的详细说明内容。 ↩

相关文章

Comments

Powered by Twikoo

评论功能尚未配置。请在部署时为环境变量 PUBLIC_TWIKOO_ENV_ID 赋值后重新部署:

该变量是 Twikoo 云函数的访问地址(形如 https://xxx.vercel.app )。云函数需要单独建一个 Vercel 项目部署(官方 templates/vercel-min),并绑定 MongoDB Atlas。