geek
61bff7beac
- 启用首页副标题（打字机效果） - 修复 nav.logo 被 theme_config 空值覆盖导致不显示的问题 - 头像改为 /images/core.jpg - 重做 logo：去白底并圆形内部填白 - 新增 Markdown 使用指南，整理文章图片到对应目录
250 lines
4.4 KiB
Markdown
250 lines
4.4 KiB
Markdown
---
|
||
title: Markdown 使用指南
|
||
date: 2026-07-08 22:00:00
|
||
tags: [Markdown, 写作, 教程]
|
||
categories: 教程
|
||
cover: /images/Markdown使用指南/markdown.webp
|
||
description: 从零掌握 Markdown 常用语法。每条语法都先给「写法」再给「效果」，照抄即可。
|
||
---
|
||
|
||
## 一、什么是 Markdown
|
||
|
||
Markdown 是一种**轻量级标记语言**，用纯文本编写，通过简单符号控制排版。优点：
|
||
|
||
- 语法简单，几分钟上手；
|
||
- 专注内容，不被格式打扰；
|
||
- 通用性强，几乎所有博客、笔记、代码托管平台都支持。
|
||
|
||
下面每一条都先给**写法**（源码），紧接着给出**效果**（实际渲染结果），方便对照学习。
|
||
|
||
## 二、标题
|
||
|
||
用 `#` 的数量表示标题层级，`#` 越多级别越低（建议全文只有一个 `#` 一级标题）。
|
||
|
||
**写法**
|
||
|
||
```markdown
|
||
# 一级标题
|
||
## 二级标题
|
||
### 三级标题
|
||
#### 四级标题
|
||
```
|
||
|
||
**效果**（演示三级与四级，一、二级即本文各章节样式）
|
||
|
||
### 这是三级标题的效果
|
||
|
||
#### 这是四级标题的效果
|
||
|
||
## 三、文本样式
|
||
|
||
### 加粗、斜体、删除线
|
||
|
||
**写法**
|
||
|
||
```markdown
|
||
**加粗文字**
|
||
*斜体文字*
|
||
***加粗斜体***
|
||
~~删除线~~
|
||
```
|
||
|
||
**效果**
|
||
|
||
**加粗文字**
|
||
*斜体文字*
|
||
***加粗斜体***
|
||
~~删除线~~
|
||
|
||
### 高亮与上下标
|
||
|
||
> 以下为扩展语法，**标准 Markdown 不渲染**，仅在 Typora、部分平台支持，本站点同样不会渲染，这里如实展示原样。
|
||
|
||
**写法**
|
||
|
||
```markdown
|
||
==高亮文字==
|
||
上标：x^2^
|
||
下标：H~2~O
|
||
```
|
||
|
||
**效果（原样，因本站点不支持）**
|
||
|
||
==高亮文字==
|
||
上标：x^2^
|
||
下标：H~2~O
|
||
|
||
## 四、列表
|
||
|
||
### 无序列表
|
||
|
||
**写法**
|
||
|
||
```markdown
|
||
- 项目一
|
||
- 项目二
|
||
- 子项目（前面加两个空格缩进）
|
||
```
|
||
|
||
**效果**
|
||
|
||
- 项目一
|
||
- 项目二
|
||
- 子项目（前面加两个空格缩进）
|
||
|
||
### 有序列表
|
||
|
||
**写法**
|
||
|
||
```markdown
|
||
1. 第一步
|
||
2. 第二步
|
||
3. 第三步
|
||
```
|
||
|
||
**效果**
|
||
|
||
1. 第一步
|
||
2. 第二步
|
||
3. 第三步
|
||
|
||
### 任务列表
|
||
|
||
> 任务列表为 GitHub 扩展语法，本站点不渲染复选框，这里展示原样写法。
|
||
|
||
**写法**
|
||
|
||
```markdown
|
||
- [x] 已完成的任务
|
||
- [ ] 待完成的任务
|
||
```
|
||
|
||
**效果（原样）**
|
||
|
||
- [x] 已完成的任务
|
||
- [ ] 待完成的任务
|
||
|
||
## 五、链接与图片
|
||
|
||
### 链接
|
||
|
||
**写法**
|
||
|
||
```markdown
|
||
[显示文字](https://example.com "可选标题")
|
||
```
|
||
|
||
**效果**
|
||
|
||
[显示文字](https://example.com "可选标题")
|
||
|
||
### 图片
|
||
|
||
**写法**
|
||
|
||
```markdown
|
||
|
||
```
|
||
|
||
**效果**
|
||
|
||
|
||
|
||
> 提示：图片语法与链接几乎一样，区别仅在于最前面多一个 `!`。本地图片可写成 `/images/文章名/图片.webp`。
|
||
|
||
## 六、代码
|
||
|
||
### 行内代码
|
||
|
||
**写法**
|
||
|
||
```markdown
|
||
使用 `npm install` 安装依赖
|
||
```
|
||
|
||
**效果**
|
||
|
||
使用 `npm install` 安装依赖
|
||
|
||
### 代码块与语法高亮
|
||
|
||
**写法**（用四个反引号包裹，内部的三反引号才能原样显示）
|
||
|
||
````markdown
|
||
```python
|
||
def hello():
|
||
print("Hello, Markdown!")
|
||
```
|
||
````
|
||
|
||
**效果**
|
||
|
||
```python
|
||
def hello():
|
||
print("Hello, Markdown!")
|
||
```
|
||
|
||
## 七、引用
|
||
|
||
**写法**
|
||
|
||
```markdown
|
||
> 引用内容
|
||
>
|
||
> > 嵌套的二级引用
|
||
```
|
||
|
||
**效果**
|
||
|
||
> 引用内容
|
||
>
|
||
> > 嵌套的二级引用
|
||
|
||
## 八、表格
|
||
|
||
**写法**
|
||
|
||
```markdown
|
||
| 语法 | 含义 | 示例 |
|
||
| ------- | ------ | ------- |
|
||
| `**x**` | 加粗 | **x** |
|
||
| `*x*` | 斜体 | *x* |
|
||
| `` `x` `` | 行内代码 | `x` |
|
||
```
|
||
|
||
**效果**
|
||
|
||
| 语法 | 含义 | 示例 |
|
||
| ------- | ------ | ------- |
|
||
| `**x**` | 加粗 | **x** |
|
||
| `*x*` | 斜体 | *x* |
|
||
| `` `x` `` | 行内代码 | `x` |
|
||
|
||
## 九、分隔线
|
||
|
||
连续三个以上的 `-`、`*` 或 `_`（独占一行）即为分隔线。
|
||
|
||
**写法**
|
||
|
||
```markdown
|
||
---
|
||
```
|
||
|
||
**效果**
|
||
|
||
---
|
||
|
||
## 十、实用扩展（平台相关）
|
||
|
||
以下语法并非所有平台都支持，按平台能力选用：
|
||
|
||
- **脚注**：`正文[^1]` 配合文末 `[^1]: 注释内容`；
|
||
- **自动目录**：部分编辑器支持 `[TOC]`；
|
||
- **emoji**：`:smile:` 显示 😄（依赖平台）；
|
||
- **数学公式**：`$E=mc^2$` 行内，`$$...$$` 独立公式块；
|
||
- **流程图**：GitHub 等支持 Mermaid 语法。
|
||
|
||
## 总结
|
||
|
||
掌握标题、文本样式、列表、链接图片、代码、引用、表格、分隔线，已能应付 90% 写作场景。核心心法：**先写内容，再管格式**，其余交给 Markdown。把本文收藏，写文章时对照查阅即可。
|