编程马·菜鸟教程

Appearance

附录：Markdown 核心知识点汇总 ​

1. 核心语法速记（按使用频率排序，附示例） ​

标题 ​

语法效果示例
# 一级标题一级标题# 一级标题
## 二级标题二级标题## 二级标题
### 三级标题三级标题### 三级标题
#### 四级标题四级标题#### 四级标题
##### 五级标题五级标题##### 五级标题
###### 六级标题六级标题###### 六级标题

文本样式 ​

语法效果示例
**加粗**加粗重要内容
*斜体*斜体强调内容
***加粗斜体***加粗斜体特别重要
~~删除线~~删除线废弃内容
<u>下划线</u>下划线强调内容

列表 ​

语法效果示例
- 无序列表无序列表- 列表项1
* 无序列表无序列表* 列表项1
+ 无序列表无序列表+ 列表项1
1. 有序列表有序列表1. 列表项1
- [x] 已完成任务列表- [x] 已完成
- [ ] 未完成任务列表- [ ] 未完成

引用 ​

语法效果示例
> 引用引用> 引用内容
> > 嵌套引用嵌套引用> > 嵌套引用

代码 ​

语法效果示例
`行内代码`行内代码print("Hello")
``` 代码块 ```代码块```python
print("Hello")

### 链接和图片

| 语法 | 效果 | 示例 |
|-----|-----|-----|
| `[链接文本](链接地址)` | [链接文本](链接地址) | [Markdown官方文档](https://daringfireball.net/projects/markdown/) |
| `![图片alt文本](图片地址)` | ![图片alt文本](图片地址) | ![Python Logo](https://www.python.org/static/img/python-logo.png) |

### 表格

| 语法 | 效果 |
|-----|-----|
| `| 表头1 | 表头2 |` | 表格 |
| `| --- | --- |` | 分隔线 |
| `| 内容1 | 内容2 |` | 表体 |

**示例**：

| 姓名 | 年龄 | 城市 |
|-----|-----|-----|
| 张三 | 20 | 北京 |
| 李四 | 25 | 上海 |

### 分割线

| 语法 | 效果 |
|-----|-----|
| `---` | 分割线 |
| `***` | 分割线 |
| `___` | 分割线 |

### 脚注

| 语法 | 效果 |
|-----|-----|
| `[^脚注标识]` | 脚注引用 |
| `[^脚注标识]: 脚注内容` | 脚注内容 |

**示例**：

这是一个脚注示例[^1]。

[^1]: 这是脚注的具体内容。

### 目录

| 语法 | 效果 |
|-----|-----|
| `[TOC]` | 自动生成目录 |

### 表情符号

| 语法 | 效果 |
|-----|-----|
| `:smile:` | 😊 |
| `:warning:` | ⚠️ |
| `:heavy_check_mark:` | ✅ |
| `:x:` | ❌ |
| `:information_source:` | ℹ️ |

### 数学公式

| 语法 | 效果 |
|-----|-----|
| `$行内公式$` | $E = mc^2$ |
| `$$块级公式$$` | $$E = mc^2$$ |

## 2. 常用工具快捷键汇总（Typora、Obsidian）

### Typora 快捷键

| 功能 | 快捷键 |
|-----|-----|
| 加粗 | `Ctrl + B` |
| 斜体 | `Ctrl + I` |
| 下划线 | `Ctrl + U` |
| 标题 1 | `Ctrl + 1` |
| 标题 2 | `Ctrl + 2` |
| 标题 3 | `Ctrl + 3` |
| 标题 4 | `Ctrl + 4` |
| 标题 5 | `Ctrl + 5` |
| 标题 6 | `Ctrl + 6` |
| 无序列表 | `Ctrl + Shift + [` |
| 有序列表 | `Ctrl + Shift + ]` |
| 任务列表 | `Ctrl + Shift + X` |
| 引用 | `Ctrl + Shift + Q` |
| 代码块 | `Ctrl + Shift + K` |
| 行内代码 | `Ctrl + Shift + C` |
| 表格 | `Ctrl + T` |
| 链接 | `Ctrl + K` |
| 图片 | `Ctrl + Shift + I` |
| 分割线 | `Ctrl + Alt + -` |
| 目录 | `Ctrl + Shift + T` |
| 实时预览 | `Ctrl + /` |
| 保存 | `Ctrl + S` |
| 导出 | `Ctrl + Shift + E` |

### Obsidian 快捷键

| 功能 | 快捷键 |
|-----|-----|
| 新建笔记 | `Ctrl + N` |
| 打开命令面板 | `Ctrl + P` |
| 快速切换 | `Ctrl + O` |
| 搜索 | `Ctrl + F` |
| 全局搜索 | `Ctrl + Shift + F` |
| 插入链接 | `Ctrl + K` |
| 插入图片 | `Ctrl + Shift + P` → 输入 "Insert image" |
| 切换编辑/预览 | `Ctrl + E` |
| 切换到新窗格 | `Ctrl + click` |
| 关闭当前窗格 | `Ctrl + W` |
| 打开图谱视图 | `Ctrl + G` |
| 打开日历 | `Ctrl + P` → 输入 "Open calendar" |
| 打开标签页 | `Ctrl + P` → 输入 "Open tag pane" |
| 打开文件浏览器 | `Ctrl + P` → 输入 "Open file explorer" |

## 3. 代码块高亮支持的编程语言汇总

| 编程语言 | 代码 | 示例 |
|-----|-----|-----|
| Python | `python` | ```python
print("Hello, World!")
``` txt
| JavaScript | `javascript` | ```javascript
console.log("Hello, World!");
``` txt
| Java | `java` | ```java
public class Hello {
    public static void main(String[] args) {
        System.out.println("Hello, World!");
    }
}
``` txt
| C | `c` | ```c
#include <stdio.h>

int main() {
    printf("Hello, World!\n");
    return 0;
}
``` txt
| C++ | `cpp` | ```cpp
#include <iostream>

int main() {
    std::cout << "Hello, World!" << std::endl;
    return 0;
}
``` txt
| C# | `csharp` | ```csharp
using System;

class Hello {
    static void Main() {
        Console.WriteLine("Hello, World!");
    }
}
``` txt
| Go | `go` | ```go
package main

import "fmt"

func main() {
    fmt.Println("Hello, World!")
}
``` txt
| Rust | `rust` | ```rust
fn main() {
    println!("Hello, World!");
}
``` txt
| Ruby | `ruby` | ```ruby
puts "Hello, World!"
``` txt
| PHP | `php` | ```php
<?php
echo "Hello, World!";
?>
``` txt
| HTML | `html` | ```html
<!DOCTYPE html>
<html>
<body>
    <h1>Hello, World!</h1>
</body>
</html>
``` txt
| CSS | `css` | ```css
body {
    background-color: lightblue;
}

h1 {
    color: white;
    text-align: center;
}
``` txt
| JSON | `json` | ```json
{
    "name": "John",
    "age": 30,
    "city": "New York"
}
``` txt
| YAML | `yaml` | ```yaml
name: John
age: 30
city: New York
``` txt
| Markdown | `markdown` | ```markdown
# Hello, World!

This is a Markdown example.
``` txt
| Bash | `bash` | ```bash
echo "Hello, World!"
``` txt
| SQL | `sql` | ```sql
SELECT * FROM users WHERE name = 'John';
``` txt
| PowerShell | `powershell` | ```powershell
Write-Host "Hello, World!"
``` txt

## 4. 常用表情标识、脚注、公式示例（复制即用）

### 常用表情标识

| 表情 | 代码 | 含义 |
|-----|-----|-----|
| 😊 | `:smile:` | 微笑 |
| 😂 | `:joy:` | 大笑 |
| 😢 | `:cry:` | 哭泣 |
| 😡 | `:angry:` | 愤怒 |
| 😎 | `:sunglasses:` | 酷 |
| 🤔 | `:thinking:` | 思考 |
| 👍 | `:thumbsup:` | 点赞 |
| 👎 | `:thumbsdown:` | 踩 |
| ⚠️ | `:warning:` | 警告 |
| ℹ️ | `:information_source:` | 信息 |
| ✅ | `:heavy_check_mark:` | 完成 |
| ❌ | `:x:` | 错误 |
| 📝 | `:memo:` | 笔记 |
| 📁 | `:file_folder:` | 文件夹 |
| 🖥️ | `:computer:` | 电脑 |

### 脚注示例

```markdown
这是一个脚注示例[^1]。

[^1]: 这是脚注的具体内容。

这是另一个脚注示例[^note]。

[^note]: 这是另一个脚注的内容。

公式示例 ​

基本运算 ​

  • 加减乘除：$a + b = c$ → $a + b = c$
  • 平方：$x^2$ → $x^2$
  • 立方：$x^3$ → $x^3$
  • 平方根：$\sqrt{x}$ → $\sqrt{x}$
  • 分数：$\frac{a}{b}$ → $\frac{a}{b}$

高级运算 ​

  • 求和：$\sum_{i=1}^n i$ → $\sum_{i=1}^n i$
  • 积分：$\int_0^1 x^2 dx$ → $\int_0^1 x^2 dx$
  • 极限：$\lim_{x \to \infty} \frac{1}{x}$ → $\lim_{x \to \infty} \frac{1}{x}$
  • 矩阵：
    markdown
    $$
\begin{pmatrix}
1 & 2 \\ 
3 & 4
\end{pmatrix}
$$
    → $$ \begin{pmatrix} 1 & 2 \ 3 & 4 \end{pmatrix} $$

物理公式 ​

  • 爱因斯坦质能方程：$E = mc^2$ → $E = mc^2$
  • 牛顿第二定律：$F = ma$ → $F = ma$
  • 勾股定理：$a^2 + b^2 = c^2$ → $a^2 + b^2 = c^2$

5. 新手易错点对照表（快速排查问题） ​

语法错误 ​

错误类型错误示例正确示例原因
标题缺少空格#标题# 标题# 与标题文本之间需要空格
列表缺少空格-列表项- 列表项列表符号与文本之间需要空格
链接缺少括号[链接](url[链接](url)链接地址需要闭合括号
图片缺少括号![图片](url![图片](url)图片地址需要闭合括号
代码块缺少结束标记```python
代码
txtpython
代码
| 行内代码缺少反引号 | `代码` | `` `代码` `` | 行内代码需要反引号包裹 |

### 排版错误

| 错误类型 | 错误示例 | 正确示例 | 原因 |
|-----|-----|-----|-----|
| 标题层级跳跃 | `# 一级标题` <br> `### 三级标题` | `# 一级标题` <br> `## 二级标题` <br> `### 三级标题` | 标题层级应该逐渐递增 |
| 列表嵌套缩进不足 | `- 一级列表` <br> `- 二级列表` | `- 一级列表` <br> `  - 二级列表` | 嵌套列表需要适当缩进 |
| 表格列数不匹配 | `| 表头1 | 表头2 |` <br> `| --- |` <br> `| 内容1 |` | `| 表头1 | 表头2 |` <br> `| --- | --- |` <br> `| 内容1 | 内容2 |` | 表格列数必须一致 |
| 引用嵌套错误 | `> 一级引用` <br> `>> 二级引用` | `> 一级引用` <br> `> > 二级引用` | 引用嵌套需要正确的缩进 |
| 空行使用不当 | `# 标题` <br> `内容` | `# 标题` <br> <br> `内容` | 标题与内容之间需要空行 |

### 链接和图片错误

| 错误类型 | 错误示例 | 正确示例 | 原因 |
|-----|-----|-----|-----|
| 链接地址缺少协议 | `[Google](google.com)` | `[Google](https://google.com)` | 链接地址需要完整的协议 |
| 本地图片路径错误 | `![图片](C:\Users\name\pic.jpg)` | `![图片](./images/pic.jpg)` | 应该使用相对路径 |
| 网络图片链接失效 | `![图片](https://example.com/nonexistent.jpg)` | `![图片](https://example.com/existent.jpg)` | 网络图片链接需要有效 |
| 缺少 alt 文本 | `![](/path/to/image.jpg)` | `![图片描述](/path/to/image.jpg)` | 图片应该添加 alt 文本 |

### 导出错误

| 错误类型 | 原因 | 解决方案 |
|-----|-----|-----|
| 导出后格式错乱 | 使用了小众语法 | 使用标准 Markdown 语法 |
| 导出后图片丢失 | 本地图片路径错误 | 使用正确的相对路径或网络图片 |
| 导出后代码块格式错误 | 代码块语法错误 | 确保代码块有正确的开始和结束标记 |
| 导出后表格格式错误 | 表格语法错误 | 确保表格列数一致，分隔线正确 |

## 6. 格式导出常见问题解决方案

### 导出为 PDF

| 问题 | 原因 | 解决方案 |
|-----|-----|-----|
| 导出后字体大小不一致 | 编辑器设置问题 | 检查编辑器的 PDF 导出设置 |
| 导出后图片模糊 | 图片分辨率低 | 使用高分辨率图片 |
| 导出后页面布局错乱 | 文档结构问题 | 调整文档结构，确保标题层级正确 |
| 导出后表格超出页面 | 表格列数过多 | 调整表格列数或使用更小的字体 |

### 导出为 Word

| 问题 | 原因 | 解决方案 |
|-----|-----|-----|
| 导出后格式丢失 | 语法兼容性问题 | 使用标准 Markdown 语法 |
| 导出后图片位置错误 | 图片路径问题 | 使用相对路径或网络图片 |
| 导出后标题样式不一致 | 样式设置问题 | 检查编辑器的 Word 导出设置 |
| 导出后代码块格式错误 | 代码块语法问题 | 确保代码块有正确的开始和结束标记 |

### 导出为 HTML

| 问题 | 原因 | 解决方案 |
|-----|-----|-----|
| 导出后样式丢失 | CSS 问题 | 自定义 HTML 导出的 CSS 样式 |
| 导出后图片不显示 | 图片路径问题 | 使用绝对路径或相对路径 |
| 导出后链接失效 | 链接地址问题 | 检查链接地址是否正确 |
| 导出后代码块无高亮 | 语法高亮问题 | 确保指定了编程语言 |

### 跨平台兼容性问题

| 问题 | 原因 | 解决方案 |
|-----|-----|-----|
| 在不同编辑器中显示不一致 | 语法解析差异 | 使用 CommonMark 标准语法 |
| 在不同平台中导出效果不同 | 平台差异 | 测试不同平台的导出效果 |
| 特殊字符显示错误 | 编码问题 | 使用 UTF-8 编码 |
| 数学公式渲染错误 | 渲染引擎差异 | 使用标准 LaTeX 语法 |

通过本附录的汇总，你可以快速参考 Markdown 的核心知识点，解决常见问题，提高文档编写效率。

© 2026 编程马·菜鸟教程 版权所有

基于 VitePress 构建