标签插件（Tag Plugins）

标签插件不应该被包裹在 Markdown 语法中

例如： []({% post_path lorem-ipsum %}) 是不被支持的。

1	![name](position/pic_name.type)

1
2
3

// on web
"pic"
pic_name

hexo的处理方式：

引用块（block quote）/引用（quote）

在文章中插入引言，可包含作者、来源和标题。

1
2
3

{% blockquote [author[, source]] [link] [source_link_title] %}
content
{% endblockquote %}

引用文章

引用其他文章的链接。

1 2	{% post_path filename %} {% post_link filename [title] [escape] %}

在使用此标签时可以忽略文章文件所在的路径或者文章的永久链接信息、如语言、日期。

例如，在文章中使用 {% post_link how-to-bake-a-cake %} 时，只需有一个名为 how-to-bake-a-cake.md 的文章文件即可。即使这个文件位于站点文件夹的 source/posts/2015-02-my-family-holiday 目录下、或者文章的永久链接是 2018/en/how-to-bake-a-cake，都没有影响。

默认链接文字是文章的标题，你也可以自定义要显示的文本。

默认对文章的标题和自定义标题里的特殊字符进行转义。可以使用escape选项，禁止对特殊字符进行转义。

嵌入图片

自 hexo-renderer-marked 3.1.0 以后可以启用自动路径解析

在 config.yml 内：

post_asset_folder: true
marked:
  prependRoot: true
  postAsset: true

启用后，资源图片将会被自动解析为其对应文章的路径

例如：

image.jpg 位置为 /2020/01/02/foo/image.jpg ，这表示它是 /2020/01/02/foo/ 文章的一张资源图片， ![](image.jpg) 将会被解析为

<img src="/2020/01/02/foo/image.jpg">

参见：https://hexo.io/zh-cn/docs/asset-folders

默认（无选项）

1	{% asset_img foo.jpg %}

1	<img src="/2020/01/02/hello/foo.jpg">

自定义 class 属性

1	{% asset_img post-image foo.jpg %}

1	<img src="/2020/01/02/hello/foo.jpg" class="post-image">

展示尺寸

1	{% asset_img foo.jpg 500 400 %}

1	<img src="/2020/01/02/hello/foo.jpg" width="500" height="400">

title 和 alt 属性

1	{% asset_img logo.svg "lorem ipsum'dolor'" %}

1	<img src="/2020/01/02/hello/foo.jpg" title="lorem ipsum" alt="dolor">