style: 配置站点副标题/Logo/头像并整理图片资源

- 启用首页副标题(打字机效果)
- 修复 nav.logo 被 theme_config 空值覆盖导致不显示的问题
- 头像改为 /images/core.jpg
- 重做 logo:去白底并圆形内部填白
- 新增 Markdown 使用指南,整理文章图片到对应目录
This commit is contained in:
2026-07-08 23:07:24 +08:00
parent e7de4af00b
commit 61bff7beac
63 changed files with 346 additions and 175 deletions
+249
View File
@@ -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
![图片描述](图片地址)
```
**效果**
![示例图片](/img/butterfly-icon.png)
> 提示:图片语法与链接几乎一样,区别仅在于最前面多一个 `!`。本地图片可写成 `/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。把本文收藏,写文章时对照查阅即可。