这篇文章来自:
content/posts/markdown-image-video-demo/index.md它的目录里有两张图片:
markdown-image-video-demo/
├── index.md
├── featured.png
└── local-demo.png1. 标题语法#
Markdown 标题使用 #:
# 一级标题
## 二级标题
### 三级标题在 Hugo 文章正文中,通常从 ## 开始写,因为文章标题已经由 front matter 的 title 生成。
2. 加粗、斜体和行内代码#
**加粗**
*斜体*
`行内代码`效果:
加粗、斜体、行内代码。
3. 列表#
无序列表:
- Hugo
- Blowfish
- Markdown效果:
- Hugo
- Blowfish
- Markdown
有序列表:
1. 创建内容
2. 添加图片
3. 本地预览效果:
- 创建内容
- 添加图片
- 本地预览
4. 代码块#
使用三个反引号:
```python
def hello():
print("Hello Hugo")
```效果:
def hello():
print("Hello Hugo")如果你在 params.toml 中设置:
enableCodeCopy = trueBlowfish 会给代码块加复制按钮。
5. 表格#
| 文件 | 类型 | 作用 |
|---|---|---|
| `_index.md` | branch bundle | 列表页或入口页 |
| `index.md` | leaf bundle | 具体文章或页面 |
| `featured.png` | 页面资源 | 缩略图或 hero 图 |效果:
| 文件 | 类型 | 作用 |
|---|---|---|
_index.md | branch bundle | 列表页或入口页 |
index.md | leaf bundle | 具体文章或页面 |
featured.png | 页面资源 | 缩略图或 hero 图 |
6. 本地图片#
写法:
效果:

这张图和 index.md 在同一个目录,所以可以直接用相对路径。
7. 外部图片#
你也可以引用外部图片:
不过个人博客更推荐把图片放在本地,这样长期更稳定。
8. 内部链接#
链接到另一篇文章:
[Hugo 内容结构示范](/posts/hugo-content-map/)效果:
9. 外部链接#
[访问 Hugo 官网](https://gohugo.io/)效果:
10. 视频嵌入占位#
Hugo 支持 shortcode。YouTube 视频常见写法:
{{< youtube REPLACE_WITH_YOUTUBE_VIDEO_ID >}}你把 REPLACE_WITH_YOUTUBE_VIDEO_ID 替换成真实视频 ID。
例如一个 YouTube 链接是:
https://www.youtube.com/watch?v=abc123xyz视频 ID 就是:
abc123xyz然后写:
{{< youtube abc123xyz >}}这里我故意用注释写法,避免你复制后立刻渲染一个无效视频。需要使用时,把 /* 和 */ 去掉。
11. 引用块#
> 这是一个引用块。效果:
这是一个引用块。适合放重要提示、摘录或警告。
12. 任务列表#
- [x] 创建 Hugo 项目
- [x] 安装 Blowfish
- [ ] 写第一篇正式文章效果:
- 创建 Hugo 项目
- 安装 Blowfish
- 写第一篇正式文章
13. 总结#
这篇文章建议你反复修改:
- 换掉
local-demo.png。 - 修改标题层级,观察目录变化。
- 添加一个新标签,观察
/tags/页面变化。 - 添加一个新分类,观察
/categories/页面变化。


