我的歌单

Markdown 完整语法指南

发表于
更新于
字数: 1.1k
时长: 13m
阅读: -
玉门

Markdown 完整语法指南

这是一份完整的 Markdown 语法参考指南,涵盖了所有常用的 Markdown 语法。


1. 标题 (Headings)

Markdown 支持 6 级标题,从 #######

这是一级标题 (H1)

这是二级标题 (H2)

这是三级标题 (H3)

这是四级标题 (H4)

这是五级标题 (H5)
这是六级标题 (H6)

标题的另一种写法(仅适用于 H1 和 H2):

这是 H1

这是 H2


2. 文本样式 (Text Formatting)

斜体 (Italic)

这是斜体文本 这也是斜体文本

粗体 (Bold)

这是粗体文本 这也是粗体文本

粗斜体 (Bold + Italic)

这是粗斜体文本 这也是粗斜体文本

删除线 (Strikethrough)

这是删除线文本

行内代码 (Inline Code)

这是一段包含 行内代码 的文本。

下划线 (Underline)

使用 HTML 标签:这是下划线文本

高亮 (Highlight)

使用 HTML 标签:这是高亮文本

上标和下标

使用 HTML 标签:

  • 下标:H2O
  • 上标:X2 + Y2 = Z2

键盘按键

Ctrl + C 复制文本。


3. 段落与换行 (Paragraphs & Line Breaks)

这是第一段。

这是第二段(段落之间需要空一行)。

强制换行:在行末输入两个空格,然后按回车。 这是第一行,后面有两个空格。 这是第二行。


4. 列表 (Lists)

无序列表 (Unordered List)

使用 *+- 作为列表标记:

  • 第一项
  • 第二项
  • 第三项
  • 第一项
  • 第二项
  • 第三项
  • 第一项
  • 第二项
  • 第三项

有序列表 (Ordered List)

  1. 第一项
  2. 第二项
  3. 第三项

嵌套列表 (Nested Lists)

  1. 第一项 1.1. 子项 1.1 1.2. 子项 1.2
  2. 第二项
    • 无序子项 A
    • 无序子项 B
  3. 第三项

任务列表 (Task List)

  • 已完成的任务
  • 未完成的任务
  • 另一个待办事项

定义列表 (Definition List)

使用 HTML 实现:

术语
术语的定义
另一个术语
另一个定义

行内链接

访问 Google

带标题的链接

悬停查看提示

相对路径链接

关于我

引用式链接

这是 引用式链接

自动链接

https://www.google.com

Email 链接

example@example.com


6. 图片 (Images)

行内图片

替代文本

带标题的图片

Logo

引用式图片

占位图

指定图片尺寸(使用 HTML)


7. 引用块 (Blockquotes)

基本引用

这是一段引用文本。

嵌套引用

外层引用

内层引用

外层引用继续

引用中的其他元素

标题

这是引用中的段落。

  • 列表项 1
  • 列表项 2

代码也能在引用中:

console.log('Hello, World!');

带作者的引用

学而不思则罔,思而不学则殆。

孔子


8. 代码块 (Code Blocks)

缩进代码块

这是一段
缩进代码块

围栏代码块 (Fenced Code Blocks)

JavaScript

function greet(name) {
    console.log(`Hello, ${name}!`);
}
 
greet('World');

Python

def greet(name):
    print(f"Hello, {name}!")
 
greet("World")

HTML

<!DOCTYPE html>
<html lang="zh-CN">
<head>
    <meta charset="UTF-8">
    <title>示例</title>
</head>
<body>
    <h1>Hello World</h1>
</body>
</html>

CSS

.container {
    display: flex;
    justify-content: center;
    align-items: center;
    height: 100vh;
}

Bash

#!/bin/bash
echo "Hello, World!"

JSON

{
    "name": "John Doe",
    "age": 30,
    "city": "New York"
}

带语法高亮和标题的代码块

/src/app/fetchMovie.js
const movies = await fetchMovies();
export async function fetchMovies() {
  const response = await fetch("http://example.com/movies.json");
  return await response.json();
}
从服务器获取电影数据

高亮特定行

const movies = await fetchMovies();
movies.map((movie, i) => {
  console.log(movie.title);
});

高亮特定内容

const movies = await fetchMovies();
movies.map((movie, i) => {
  console.log(movie.title);
});

显示行号

const movies = await fetchMovies();
movies.map((movie, i) => {
  console.log(movie.title);
});

9. 表格 (Tables)

基本表格

列1列2列3
数据1数据2数据3
数据4数据5数据6

对齐方式

左对齐居中右对齐
内容1内容2内容3
较长内容居中右对齐

表格中的样式

列1列2列3
斜体粗体代码
删除链接图片

复杂表格

功能语法示例
粗体**text**粗体
斜体*text*斜体
删除线~~text~~删除线
代码`code`code

10. 分隔线 (Horizontal Rules)

以下三种方式都可以创建分隔线:





11. 转义字符 (Escaping)

使用反斜杠 \ 转义特殊字符:

* 不是斜体 * # 不是标题 [ 不是链接 ` 不是代码

可转义的字符:\ * _ { } [ ] ( ) # + - . ! |


12. HTML 内联 (Inline HTML)

Markdown 支持在文档中使用 HTML 标签:

使用 <br> 强制换行

第一行
第二行
第三行

自定义样式

这是红色文本

这是大号文本

缩写标签

GIF 是一种位图图像格式。

其他 HTML 元素

点击展开详情 这是隐藏的内容,点击后可以查看。

13. 脚注 (Footnotes)

这是一个带有脚注的文本 1

这是另一个脚注 2

你可以使用粗体和其他样式在脚注中 3


14. 数学公式 (Math) - 需要插件支持

行内公式

爱因斯坦质能方程:E=mc2E = mc^2

块级公式

欧拉公式:

eiπ+1=0e^{i\pi} + 1 = 0

二次方程求根公式:

x=b±b24ac2ax = \frac{-b \pm \sqrt{b^2 - 4ac}}{2a}

矩阵:

(abcd)\begin{pmatrix} a & b \\ c & d \end{pmatrix}

15. Mermaid 图表 - 需要插件支持

流程图

graph TD
    A[开始] --> B{判断}
    B -->|是| C[执行]
    B -->|否| D[跳过]
    C --> E[结束]
    D --> E

时序图

sequenceDiagram
    participant 用户
    participant 系统
    用户->>系统: 发送请求
    系统-->>用户: 返回响应

甘特图

gantt
    title 项目进度
    dateFormat  YYYY-MM-DD
    section 开发
    需求分析 :a1, 2026-01-01, 7d
    编码实现 :a2, after a1, 14d
    section 测试
    功能测试 :b1, after a2, 7d

16. Emoji 表情

直接使用 emoji 字符:

😀 😃 😄 😁 😆 😅 🤣 😂

或者使用短代码(需要插件):

😄 ❤️ 💯 🔥


17. 其他常用 HTML 标签

时间标签

删除标签

这段文本已被删除

插入标签

这是新增的文本

引用标签

这是引用来源

键盘按键快捷键

Ctrl + Alt + Delete


总结

以上是 Markdown 的完整语法指南。掌握这些语法,你就可以:

  • ✅ 写出格式丰富的文档
  • ✅ 创建结构化的内容
  • ✅ 添加代码和数学公式
  • ✅ 插入图片和链接
  • ✅ 制作表格和列表

祝写作愉快! 🎉

Footnotes

  1. 这是第一个脚注的说明。

  2. 这是一个命名的脚注。

  3. 脚注也可以包含格式化文本,并且可以跨越多行。

评论

0
QQ

加载评论中...