写作指南

使用 Markdown、组件和高级功能掌握内容创作

jet-w
3min

写作指南

学习如何为你的博客创作精美、引人入胜的内容。

内容指南

指南描述
容器提示框、警告框和标注
代码块语法高亮和功能
Mermaid 图表流程图、时序图等
图标使用多个图标库的图标
LaTeX 数学数学公式
视频嵌入YouTube、Bilibili、自定义视频
幻灯片使用 Reveal.js 创建交互式演示文稿

Markdown 基础

Markdown 是一种轻量级标记语言,让格式化内容的编写变得简单直观。

标题

使用 # 符号表示标题:

# 一级标题
## 二级标题
### 三级标题
#### 四级标题
最佳实践
  • 每页只使用一个 # 一级标题(你的标题)
  • 不要跳级(不要从 ## 跳到 ####
  • 保持标题简洁

文本格式

基本样式

语法结果用途
**粗体**粗体重要术语
*斜体*斜体强调
~~删除线~~删除线已弃用的内容
`代码`代码行内代码

组合样式

***粗斜体***
**粗体中有 `代码`**

链接

基本链接

[链接文本](https://example.com)
[带标题的链接](https://example.com "悬停文本")

内部链接

链接到其他文章:

[查看指南](./02-containers)
[返回首页](/)

图片

基本图片

![替代文本](/images/photo.jpg)

带说明的图片

![美丽的日落](/images/sunset.jpg)
*海上美丽的日落*

图片尺寸

使用 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      |
左对齐居中右对齐
LCR

转义字符

使用反斜杠显示字面字符:

\*非斜体\*
\# 非标题

*非斜体*


下一步:学习 容器 来创建标注和提示。