style: 配置站点副标题/Logo/头像并整理图片资源
- 启用首页副标题(打字机效果) - 修复 nav.logo 被 theme_config 空值覆盖导致不显示的问题 - 头像改为 /images/core.jpg - 重做 logo:去白底并圆形内部填白 - 新增 Markdown 使用指南,整理文章图片到对应目录
This commit is contained in:
@@ -0,0 +1,249 @@
|
||||
---
|
||||
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。把本文收藏,写文章时对照查阅即可。
|
||||
Reference in New Issue
Block a user