写作指南
学习如何为你的博客创作精美、引人入胜的内容。
内容指南
| 指南 | 描述 |
|---|---|
| 容器 | 提示框、警告框和标注 |
| 代码块 | 语法高亮和功能 |
| Mermaid 图表 | 流程图、时序图等 |
| 图标 | 使用多个图标库的图标 |
| LaTeX 数学 | 数学公式 |
| 视频嵌入 | YouTube、Bilibili、自定义视频 |
| 幻灯片 | 使用 Reveal.js 创建交互式演示文稿 |
Markdown 基础
Markdown 是一种轻量级标记语言,让格式化内容的编写变得简单直观。
标题
使用 # 符号表示标题:
# 一级标题
## 二级标题
### 三级标题
#### 四级标题
最佳实践
- 每页只使用一个
# 一级标题(你的标题) - 不要跳级(不要从
##跳到####) - 保持标题简洁
文本格式
基本样式
| 语法 | 结果 | 用途 |
|---|---|---|
**粗体** | 粗体 | 重要术语 |
*斜体* | 斜体 | 强调 |
~~删除线~~ | 已弃用的内容 | |
`代码` | 代码 | 行内代码 |
组合样式
***粗斜体***
**粗体中有 `代码`**
链接
基本链接
[链接文本](https://example.com)
[带标题的链接](https://example.com "悬停文本")
内部链接
链接到其他文章:
[查看指南](./02-containers)
[返回首页](/)
图片
基本图片

带说明的图片

*海上美丽的日落*
图片尺寸
使用 HTML 进行更多控制:
<img src="/images/photo.jpg" alt="照片" width="300" />
列表
无序列表
- 项目一
- 项目二
- 嵌套项目
- 另一个嵌套
- 项目三
结果:
- 项目一
- 项目二
- 嵌套项目
- 另一个嵌套
- 项目三
有序列表
1. 第一步
2. 第二步
3. 第三步
任务列表
- [x] 已完成的任务
- [ ] 待完成的任务
- [ ] 另一个任务
- 已完成的任务
- 待完成的任务
- 另一个任务
引用
> 这是一段引用。
> 可以跨越多行。
> 嵌套引用:
>> 也是可以的
这是一段引用。 可以跨越多行。
分隔线
使用以下方式创建分隔线:
---
表格
| 列 1 | 列 2 | 列 3 |
|------|------|------|
| 单元格 1 | 单元格 2 | 单元格 3 |
| 单元格 4 | 单元格 5 | 单元格 6 |
| 列 1 | 列 2 | 列 3 |
|---|---|---|
| 单元格 1 | 单元格 2 | 单元格 3 |
| 单元格 4 | 单元格 5 | 单元格 6 |
表格对齐
| 左对齐 | 居中 | 右对齐 |
|:-------|:----:|-------:|
| L | C | R |
| 左对齐 | 居中 | 右对齐 |
|---|---|---|
| L | C | R |
转义字符
使用反斜杠显示字面字符:
\*非斜体\*
\# 非标题
*非斜体*
下一步:学习 容器 来创建标注和提示。