title: Markdown在Next下的高级书写 tags:
- Bolg categories: Bolg abbrlink: 73564
{% note info %} 本文中列出了Next特殊的Markdown渲染格式,在其他环境写作时不一定支持。 若想在不支持的环境下使用,可以在对应的环境中修改主题对应的css样式:把next主题中的这种标签的css样式复制到环境下的css源码中,这样就可以在自己使用的写作环境中支持了 {% endnote %}
{% tabs 演示, 2 %} 注意要点
-
个人常用格式 以下为样式示例,点击可调至对应演示:
-
{% endtabs %}
Next下的note标签
0、note格式
{% note [class] [no-icon] %}
这里写你需要写的内容
{% endnote %}
// 注意上面的class和no-icon属性是可以选择的
[class] : default | primary | success | info | warning | danger.
[no-icon] : Disable icon in note.
1、没有定义样式类别
{% note %}
(没有定义样式类别)
{% endnote %}
{% note %} (没有定义样式类别) {% endnote %}
2、默认的类别
{% note default %}
默认形式的类别
{% endnote %}
{% note default %} 默认形式的类别 {% endnote %}
3、primary形式的类别
{% note primary %}
首要类型形式
{% endnote %}
{% note primary %} 首要类型形式 {% endnote %}
4、info形式的类别
{% note info %}
info形式的类别
{% endnote %}
{% note info %} info形式的类别 {% endnote %}
5、success形式的类别
{% note success %}
success形式的类别
{% endnote %}
{% note success %} success形式的类别 {% endnote %}
6、warning形式的类别
{% note warning %}
warning形式的类别
{% endnote %}
{% note warning %} warning形式的类别 {% endnote %}
7、danger形式的类别
{% note danger %}
danger形式的类别
{% endnote %}
{% note danger %} danger形式的类别 {% endnote %}
8、无图标形式的note标签
{% note info no-icon %}
没有图标的note标签
{% code %}
code block in note tag
code block in note tag
code block in note tag
{% endcode %}
{% endnote %}
{% note info no-icon %} 没有图标的note标签 {% code %} code block in note tag code block in note tag code block in note tag {% endcode %} {% endnote %}
9、无图标形式的success标签
{% note success %}
在note中插入代码块
{% code %}
code block in note tag
code block in note tag
code block in note tag
{% endcode %}
{% endnote %}
{% note success %} 在note中插入代码块 {% code %} code block in note tag code block in note tag code block in note tag {% endcode %} {% endnote %}
10、note标签中插入有序无序列表
{% note default %}
在note中放入无序、有序列表
* ul
* ul
* ul
1\. ol
2\. ol
3\. ol
{% endnote %}
{% note default %} 在note中放入无序、有序列表
- ul
- ul
-
ul
-
ol
-
ol
-
ol {% endnote %}
11、note标签中插入表格
{% note default %} | 1 | 2 | | - | - | | 3 | 4 | | 5 | 6 | | 7 | 8 | {% endnote %}
{% note default %} | 1 | 2 | | - | - | | 3 | 4 | | 5 | 6 | | 7 | 8 | {% endnote %}
Next下的note标签(HTML)
<div class="note default"><p>default</p></div>
default<div class="note primary"><p>primary</p></div>
primary<div class="note success"><p>success</p></div>
success<div class="note info"><p>info</p></div>
info<div class="note warning"><p>warning</p></div>
warning<div class="note danger"><p>danger</p></div>
danger<div class="note danger no-icon"><p>danger no-icon</p></div>
FontAwesome图标优化
- 支持 Markdown Hexo 支持 GitHub Flavored Markdown 的所有功能,甚至可以整合 Octopress 的大多数插件。
- 一件部署 只需一条指令即可部署到 GitHub Pages,或其他网站。
- 丰富的插件 Hexo 拥有强大的插件系统,安装插件可以让 Hexo 支持 Jade,CoffeeScript。
源码:
1\. <i class="fa fa-pencil"></i> 支持 Markdown
<i>Hexo 支持 GitHub Flavored Markdown 的所有功能,甚至可以整合 Octopress 的大多数插件。</i>
2\. <i class="fa fa-cloud-upload"></i> 一件部署
<i>只需一条指令即可部署到 GitHub Pages,或其他网站。</i>
3\. <i class="fa fa-cog"></i> 丰富的插件
<i>Hexo 拥有强大的插件系统,安装插件可以让 Hexo 支持 Jade,CoffeeScript。</i>
采用的是 Font Awesome 的图标,下面给出一些简单的使用例子,更多请查看官网的使用示例。
采用的是 Font Awesome 的图标,下面给出一些简单的使用例子,更多请查看官网的使用示例。
- <i class="fa fa-pencil"></i> 铅笔
- <i class="fa fa-cloud-upload"></i> 上传
- <i class="fa fa-download"></i> 下载
- 铅笔
- 上传
- 下载 ```
- 下载
- 下载变大 33%
- 下载两倍大 ```
- 下载
- 下载变大 33%
-
下载两倍大
diff语言完成代码块内部样式高亮
Next主题其实是自带代码块高亮显示的,但是有另外一种好玩的代码块高亮写法,叫
diff
语言 ```diff highlight: enable: true line_number: true代码自动高亮
-
auto_detect: false
-
auto_detect: true
只需要在markdown语法代码块的语言选择处写上`diff`即可,然后在相应代码前面加上`-`和`+`就行了。不过默认的`-`是绿色,`+`是红色,与 GitHub 上相反,也可以自己修改成Github上样式。
// 文章```代码块diff样式 pre .addition { background: #e6ffed; } pre .deletion { background: #ffeef0; }
当然,要是你不满意顶部的文字样式,也可以自己在`custom.styl`自定义:
// 文章
代码块顶部样式 .highlight figcaption { margin: 0em; padding: 0.5em; background: #eee; border-bottom: 1px solid #e9e9e9; } .highlight figcaption a { color: rgb(80, 115, 184); }
文本居中引用
效果: {% cq %} 人生乃是一面镜子, 从镜子里认识自己, 我要称之为头等大事, 也只是我们追求的目的! {% endcq %}
{% cq %}
人生乃是一面镜子,
从镜子里认识自己,
我要称之为头等大事,
也只是我们追求的目的!
{% endcq %}
Next下的label标签
首先需要在Next主题_config.xml
中配置:
# Label tag.
label: true
然后效果如下(@ 前面的是label的名字,后面的是要显示的文字):
{% label default@default %}
{% label default@default %}
{% label primary@primary %}
{% label primary@primary %}
{% label success@success %}
{% label success@success %}
{% label info@info %}
{% label info@info %}
{% label warning@warning %}
{% label warning@warning %}
{% label danger@danger %}
{% label danger@danger %}
Next下的tabs标签
效果: {% tabs 选项卡, 2 %} 这是选项卡 1 11111 这是选项卡 2 22222 这是选项卡 3 33333 {% endtabs %} 源码:
{% tabs 选项卡, 2 %}
<!-- tab 自定义名1-->
**这是选项卡 1** 11111
<!-- endtab -->
<!-- tab 自定义名2-->
**这是选项卡 2** 22222
<!-- endtab -->
<!-- tab 自定义名3-->
**这是选项卡 3** 33333
<!-- endtab -->
{% endtabs %}
首先还是需要在Next主题配置文件中配置
# Tabs tag.
tabs:
enable: true
transition:
tabs: true
labels: true
border_radius: 0
然后上面源码中, 2表示一开始在第二个选项卡,非必须,若数值为-1则隐藏选项卡内容。更多用法请查看这个页面。
Next下的样式按钮
效果: {% btn https://www.baidu.com, 点击下载百度, download fa-lg fa-fw %}
源码:
{% btn https://www.baidu.com, 点击下载百度, download fa-lg fa-fw %}
关于按钮的更多使用可以前往这个页面查看。
页面内锚点
-
在需要跳转的位置添加锚点
<span id="jump">跳转到的地方</span>
-
在需要点击跳转的位置,使用上面的id,格式类似超链接的形式:
[点击跳转](#jump)
-
如目录语法为:
[MarkDown页面内跳转测试](#jump)
-
下面实际目录语法为:
<span id="jump">MarkDown页面内跳转测试</span>
例子:
```
标题
目录
1. 目录1
2. 目录2
## <span id="jump4">note标签的官方文档使用</span>
首先我们需要在Next主题`_config.xml`中设置一下功能开关,有些默认是开的,有些默认是关的:
note:
Note tag style values:
- simple bs-callout old alert style. Default.
- modern bs-callout new (v2-v3) alert style.
- flat flat callout style with background, like on Mozilla or StackOverflow.
- disabled disable all CSS styles import of note tag.
style: simple icons: false border_radius: 3
Offset lighter of background in % for modern and flat styles (modern: -12 | 12; flat: -18 | 6).
Offset also applied to label tag variables. This option can work with disabled note tag.
light_bg_offset: 0
## <span id="jump5">注意事项</span>
内容`必须`要跟note标签`不在`一行:
{% note success %}
{% note danger %} note text, note text, note text note text, note text, note text note text, note text, note text {% endnote %}
{% endnote %}
错误演示:
{% note danger %}
{% note danger %}note text, note text, note text{% endnote %}
{% endnote %}
{% note danger %}
{% note danger %}note text note text note text {% endnote %}
{% endnote %}
# <span id="jump3">个人常用格式</span>
```
{% tabs 选项卡, 2 %} 这是选项卡 1 内容1 这是选项卡 2 内容2 这是选项卡 3 内容3 {% endtabs %}
目录
1. 目录1
2. 目录2
文章末尾
``````
版权声明:《 Markdown在Next下的高级书写 》为Ethan原创文章,转载请注明出处!
最后编辑:2020-6-8 11:06:30