0%

博客写作技巧篇


更新了next和hexo后,发现next有一些标签可以直接在Markdown文档上使用

Markdown的基本语法我就不在说了,说一下next的标签使用,原文参考大佬的博客,谢谢大佬的无私奉献

文本居中标签

1
2
3
4
5
使用{% centerquote %}或者{% cq %}标签包裹内容,实现内容居中的效果。

注意内容后要用{% endcenterquote %}或{% endcq %}结尾。

例如下方展示: {% cq %} 谢谢你 {% endcq %}

谢谢你

代码块进阶用法

写作技巧链接地址
1
点击右上方的链接地址就可以打开这篇博客

代码块进阶语法规则:

``` language title url link text
code snippet
```

其中,各参数意义如下:

  • langugae:语言名称,引导渲染引擎正确解析并高亮显示关键字
  • title:代码块标题,将会显示在左上角
  • url:链接地址,如果没有指定 link text 则会在右上角显示 link
  • link text:链接名称,指定 url 后有效,将会显示在右上角
  • url 必须为有效链接地址才会以链接的形式显示在右上角,否则将作为标题显示在左上角。以 url 为分界,左侧除了第一个单词会被解析为 language,其他所有单词都会被解析为 title,而右侧的所有单词都会被解析为 link text。

如果不想填写 title,可以在 language 和 url 之间添加至少三个空格。

note 标签

通过 note 标签可以为段落添加背景色,语法如下:

1
2
3
{% note class  %}
文本内容 (支持行内标签)
{% endnote %}

支持的 class 种类包括 default primary success info warning danger,也可以不指定 class。

各种 class 种类的效果如下:

primary

success

info

warning

danger

不写class,默认是这个颜色

更多配置可在主题配置文件中设置

config.yml
1
2
3
4
5
6
note:
# Note 标签样式预设
style: modern # simple | modern | flat | disabled
icons: false # 是否显示图标
border_radius: 3 # 圆角半径
light_bg_offset: 0 # 默认背景减淡效果,以百分比计算

label 标签

通过 label 标签可以为文字添加背景色,语法如下:

1
2
3
4
5
6
7
8
9
10
// 语法格式
{% label class@text %}

// 具体范例
{% label @default %}
{% label primary@primary %}
{% label success@success %}
{% label info@info %}
{% label warning@warning %}
{% label danger@danger %}

支持的 class 种类包括 default primary success info warning danger,默认使用 default 作为缺省。

具体效果如下:

default
primary
success
info
warning
danger

button 按钮

通过 button 标签可以快速添加带有主题样式的按钮,语法如下:

1
2
3
4
5
6
7
8
// 语法格式
{% button /path/to/url/, text, icon [class], title %}

// 具体范例
{% btn #, 文本 %}
{% btn #, 文本 & 标题,, 标题 %}
{% btn #, 文本 & 图标, home %}
{% btn #, 文本 & 大图标 (固定宽度), home fa-fw fa-lg %}

效果如下

文本 文本 & 标题 文本 & 图标 文本 & 大图标 (固定宽度)

tab 标签

tab 标签用于快速创建 tab 选项卡,语法如下

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
// 语法格式
{% tabs [Unique name], [index] %}
<!-- tab [Tab caption]@[icon] -->
标签页内容(支持行内标签)
<!-- endtab -->
{% endtabs %}

// 具体范例
{% tabs Tab标签列表 %}
<!-- tab 第一页 -->
标签页1文本内容
<!-- endtab -->
<!-- tab 第二页 -->
标签页2文本内容
<!-- endtab -->
<!-- tab 第三页 -->
标签页3文本内容
<!-- endtab -->
{% endtabs %}

其中,各参数意义如下:

  • Unique name: 全局唯一的 Tab 名称,将作为各个标签页的 id 属性前缀
  • index: 当前激活的标签页索引,如果未定义则默认选中显示第一个标签页,如果设为 - 1 则默认隐藏所有标签页
  • Tab caption: 当前标签页的标题,如果不指定则会以 Unique name 加上索引作为标题
  • icon: 在标签页标题中添加 Font awesome 图标

具体效果如下:

标签页1文本内容

标签页2文本内容

标签页3文本内容

-------------本文结束感谢您的阅读-------------
没办法,总要恰饭的嘛~~