2025-06-25发表Guides7 分钟读完 (大约1061个字)

Icarus 用户指南｜Hexo 内置标签指南

以下内容取自 Hexo 文档并略有修订。

标签插件与文章标签不同。它们从 Octopress 移植而来，为你快速添加特定内容到文章中提供了一种实用方法。

块引用

非常适合在文章中添加引用内容，可选择性包含作者、来源和标题信息。

别名： quote

1
2
3

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

示例

不带参数。普通块引用。

1
2
3

{% blockquote %} 
Lorem ipsum dolor sit amet, consectetur adipiscing elit. Pellentesque hendrerit lacus ut purus iaculis feugiat. Sed nec tempor elit, quis aliquam neque. Curabitur sed diam eget dolor fermentum semper at eu lorem.
{% endblockquote %}

Lorem ipsum dolor sit amet, consectetur adipiscing elit. Pellentesque hendrerit lacus ut purus iaculis feugiat. Sed nec tempor elit, quis aliquam neque. Curabitur sed diam eget dolor fermentum semper at eu lorem.

引用自书籍

1
2
3

{% blockquote David Levithan, Wide Awake %}
不要只为自己寻求幸福。要为所有人寻求幸福。通过仁慈。通过怜悯。
{% endblockquote %}

不要只为自己寻求幸福。要为所有人寻求幸福。通过仁慈。通过怜悯。

David LevithanWide Awake

引用自 Twitter

1
2
3

{% blockquote @DevDocs https://twitter.com/devdocs/status/356095192085962752 %}
新功能：DevDocs 现在带有语法高亮功能。http://devdocs.io 
{% endblockquote %}

新功能：DevDocs 现在带有语法高亮功能。http://devdocs.io

@DevDocstwitter.com/devdocs/status/356095192085962752

引用自网页文章

1
2
3

{% blockquote Seth Godin http://sethgodin.typepad.com/seths_blog/2009/07/welcome-to-island-marketing.html 欢迎来到 Island Marketing %}
每一次互动都弥足珍贵，也是一次愉悦的机会。
{% endblockquote %}

每一次互动都弥足珍贵，也是一次愉悦的机会。

Seth Godin欢迎来到 Island Marketing

代码块

这是在文章中添加代码片段的实用功能。

别名： code

1
2
3

{% codeblock [title] [lang:language] [url] [链接文本] [附加选项] %}
代码片段
{% endcodeblock %}

示例

普通代码块

1
2
3

{% codeblock %} 
alert('你好，世界！'); 
{% endcodeblock %}

1	alert('你好，世界！');

指定语言

1
2
3

{% codeblock lang:objc %}
[rectangle setX: 10 y: 10 width: 20 height: 20];
{% endcodeblock %}

1	[rectangle setX: 10 y: 10 width: 20 height: 20];

为代码块添加标题

1
2
3

{% codeblock Array.map %}
array.map(callback[, thisArg]) 
{% endcodeblock %}

Array.map

1	array.map(callback[, thisArg])

添加标题和 URL

{% codeblock _.compact http://underscorejs.org/#compact Underscore.js %}
_.compact([0, 1, false, 2, '', 3]); 
=> [1, 2, 3] 
{% endcodeblock %}

_.compactUnderscore.js

1 2	_.compact([0, 1, false, 2, '', 3]); => [1, 2, 3]

反引号代码块

这与使用代码块相同，但使用三个反引号来分隔代码块。

1	`` [language] [title] [url] [link text] code snippet ``

拉取引用

要在文章中添加拉取引用：

1
2
3

{% pullquote [class] %}
内容
{% endpullquote %}

iframe

嵌入 iframe：

1	{% iframe url [宽度] [高度] %}

图片

插入指定大小的图片。

1	{% img [类名] /path/to/image [宽度] [高度] '"标题文本" "替代文本"' %}

100% 100% "Vector Landscape" "Vector Landscape"

链接

插入带有 target="_blank" 属性的链接。

1	{% 链接文本 url [外部] [标题] %}

Hexo.io

包含代码

插入 source/downloads/code 文件夹中的代码片段。

1	{% include_code [标题] [语言：语言] [发件人：行] [收件人：行] 路径/到/文件 %}

示例

嵌入 test.js 的全部内容

1	{% include_code lang:javascript test.js %}

仅嵌入第 3 行

1	{% include_code lang:javascript 从：3 到：3 test.js %}

嵌入第 5 至 8 行

1	{% include_code lang:javascript 从：5 到：8 test.js %}

将第 5 行嵌入到文件末尾

1	{% include_code lang:javascript 来自:5 test.js %}

嵌入第 1 至 8 行

1	{% include_code lang:javascript 到:8 test.js %}

包含文章

包含指向其他文章的链接。

1 2	{% post_path 文件名 %} {% post_link 文件名 [标题] [转义] %}

包含资源

包含文章资源。

1
2
3

{% asset_path 文件名 %} 
{% asset_img [类名] slug [宽度] [高度] [标题文本 [替代文本]] %} 
{% asset_link 文件名 [标题] [转义] %}

原始内容

如果某些内容在文章处理中导致问题，可以使用 raw 标签将其包裹，以避免渲染错误。

1
2
3

{% raw %}
内容
{% endraw %}

文章摘要

将  标签之前的文本用作帖子的摘要。如果在前置事项中指定了 excerpt: 值，则该值优先。

示例:

1
2
3

Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.
<!-- more -->
Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.