eDiary Markdown 手册

概述

eDiary 支持使用 Markdown 语法编辑和渲染文章。Markdown 是一种轻量级标记语言，它允许您使用纯文本格式编写文档，同时可转换为格式丰富的富文本。

点击编辑器工具栏的最左侧的 更改文档格式 按钮，即可设置当前文章的格式。

当设置为 Markdown 格式时，您可以直接在编辑器中编写 Markdown 语法，切换到阅读模式（F8）后会渲染为格式化文本。保存时，Markdown 原文会被保存为纯文本，而嵌入的图片等资源则会被打包存储。

1. 标题

语法

# 一级标题
## 二级标题
### 三级标题
#### 四级标题
##### 五级标题
###### 六级标题

效果

一级标题

二级标题

三级标题

四级标题

五级标题

六级标题

2. 文字样式

2.1 粗体

2.2 斜体

2.3 删除线

2.4 高亮标记

使用两个等号 == 包裹文字，文字会以黄色背景高亮显示。

2.5 下标

使用单个波浪线 ~ 包裹文字：

2.6 上标

使用脱字符 ^ 包裹文字：

2.7 混合使用示例

X~n~^k^        <!-- 下标 n 跟上标 k -->
CH~3~CH~2~OH   <!-- 化学式：CH₃CH₂OH -->

• ~~（两个波浪线）→ 删除线
• ~（单个波浪线）→ 下标
• 二者使用不同的符号数量来区分，不会冲突。

3. 引用

语法

> 这是一段引用文字

效果

这是一段引用文字

4. 列表

4.1 无序列表

语法

- 项目一
- 项目二
- 项目三

效果

• 项目一
• 项目二
• 项目三

4.2 有序列表

语法

1. 第一项
2. 第二项
3. 第三项

效果

1. 第一项
2. 第二项
3. 第三项

4.3 任务列表

语法

- [ ] 待办事项一
- [ ] 待办事项二
- [x] 已完成的事项

效果

• [ ] 待办事项一
• [ ] 待办事项二
• [x] 已完成的事项

5. 代码

5.1 行内代码

语法

这是一段 `行内代码` 示例。

效果

这是一段 行内代码 示例（文字以等宽字体显示，带浅色背景）。

5.2 代码块

语法

```
program Hello;
begin
  WriteLn('Hello, World!');
end;
```

效果

program Hello;
begin
  WriteLn('Hello, World!');
end;

代码块在编辑器和阅读器中会以等宽字体显示，背景色与其他文字区分开，方便阅读代码。可以在开头反引号后指定编程语言名称，获得语法高亮。

6. 表格

语法

| 姓名   | 年龄 | 城市   |
|--------|------|--------|
| 张三   | 28   | 北京   |
| 李四   | 32   | 上海   |

第二行的 |--- 用于分隔表头和表格主体，每个 --- 对应一列。列之间的对齐方式可以通过调整 : 的位置来控制（:--- 左对齐，:--: 居中，---: 右对齐）。

效果

7. 链接与图片

7.1 超链接

语法

[链接文字](https://example.com)

效果

链接文字（文字显示为蓝色可点击链接）。

7.2 本地图片（资源图片）

通过编辑器工具栏的"插入图片"功能添加的图片，会被保存到文章的资源目录中，并使用相对路径引用：

![图片描述](img1.png)

这些图片会随文章一起打包存储，在阅读时自动加载。

7.3 外部图片链接（图片外链）

eDiary 支持使用外部图片链接，您可以直接引用互联网上的图片：

![网络图片](https://haoxg.net/assets/images/ediary-ui-sd.png)

特点说明：

• 外链图片不需要上传到 eDiary 的本地资源目录，直接使用图片的完整 URL 即可。
• 在编辑器中和阅读模式下，eDiary 会自动从网络加载并显示这些图片。
• 这对于引用博客配图、头像、网络表情等场景非常方便。
• 外链图片不会被打包到文章资源中，因此阅读时需要网络连接才能正常显示。
• 您可以在同一篇文章中混合使用本地资源图片和外部链接图片。

8. 分割线

语法

---

使用三个或更多的 -、* 或 _ 单独成行。

9. 转义字符

如果需要在 Markdown 中显示特殊字符的字面值，可以在前面加反斜杠 \ 进行转义：

语法与效果对照

需要转义的字符

\  `  *  _  {  }  [  ]  (  )  #  +  -  .  !  |  ~  ^  =

10. 编辑器设置

在 eDiary 的设置中可以找到 Markdown 相关的配置项。

10.1 编辑器设置

10.2 阅读器设置

附录：语法与效果快速对照表