Jekyll中Markdown常用代码段

简介：Jekyll中Markdown常用代码段

1、提示™、说明以及警告

<div class="note">
  <h5>提示™帮助你更好的使用 Jekyll</h5>
  <p>这儿有各种小技巧让你成为 Jekyll 的魔法师</p>
</div>

<div class="note info">
  <h5>说明包含一些有用的信息</h5>
  <p>这儿提供一些帮助理解 Jekyll 的其他内容</p>
</div>

<div class="note warning">
  <h5>警告帮助你不出错</h5>
  <p>如果不想出错，请注意这类消息</p>
</div>

<div class="note unreleased">
  <h5>尚未发布的功能</h5>
  <p>这部分内容针对 Jekyll 尚未发布的版本</p>
</div>

提示™帮助你更好的使用 Jekyll

这儿有各种小技巧让你成为 Jekyll 的魔法师

说明包含一些有用的信息

这儿提供一些帮助理解 Jekyll 的其他内容

警告帮助你不出错

如果不想出错，请注意这类消息

尚未发布的功能

这部分内容针对 Jekyll 尚未发布的版本

2、高亮代码片段

{% highlight ruby %}
def show
  @widget = Widget(params[:id])
  respond_to do |format|
    format.html # show.html.erb
    format.json { render json: @widget }
  end
end
{% endhighlight %}

将输出下面的效果：

def show
  @widget = Widget(params[:id])
  respond_to do |format|
    format.html # show.html.erb
    format.json { render json: @widget }
  end
end

提示™：显示行数

你可以在代码片段中增加关键字 linenos 来显示行数。这样完整的高亮开始标记将会是: {% highlight ruby linenos %}。

3、常用代码高亮语言

text
html
js
php
mysql
python

本博客使用 Pygments 实现代码高亮，Pygments 支持超过一百种语言。可以在 Pygments’ Lexers page 寻找对应语言的 “short name”。

4、链接

[关于我](/about)

关于我

5、博文链接（Post URL）

如果你想使用你某篇文章的链接，标签 post_url 可以满足你的需求。

{% post_url 2010-07-21-name-of-post %}

如果你使用了子文件夹来组织你的博文，你需要在路径中加入子文件夹：

{% post_url /subdir/2010-07-21-name-of-post %}

当使用post_url标签时，不需要写文件后缀名。

还可以用 Markdown 这样为你的文章生成超链接：

[Name of Link]({% post_url 2010-07-21-name-of-post %})

6、引用图片和其它资源

在文章中引用一个图片

… 从下面的截图可以看到：
![有帮助的截图]({{ site.url }}/assets/screenshot.jpg)

链接一个读者可下载的 PDF 文件：

… 你可以直接 [下载 PDF]({{ site.url }}/assets/mydoc.pdf).

提示™：链接只使用站点的根 URL

如果你确信你的站点只在域名的根 URL 下做展示，你可以不使用 {{ site.url }} 变量。在这种情况下，直接使用 /path/file.jpg 即可。

7、使用 font-awesome

<b>
<i class="fa fa-tags"/>
Tag | 标签：
</b>

Tag | 标签：

8、表格

字符|UTF-8编码后的十六进制
|-|-|
很|E5BE88
屌|E5B18C

字符|UTF-8编码后的十六进制
很|E5BE88
屌|E5B18C

字符	UTF-8编码后的十六进制
很	E5BE88
屌	E5B18C

字符	UTF-8编码后的十六进制
很	E5BE88
屌	E5B18C

9、有序列表

1. 若要安装一套主题，请先将该主题添加到您站点的 `Gemfile` 中：

        gem 'my-awesome-jekyll-theme'

2. 保存并应用 `Gemfile` 中相关的文件变化。
3. 执行命令行 `bundle install` 来安装主题。
4. 最后, 向您站点的 `_config.yml` 中加入下列代码来启用主题

若要安装一套主题，请先将该主题添加到您站点的 Gemfile 中：
```
 gem 'my-awesome-jekyll-theme'
```
保存并应用 Gemfile 中相关的文件变化。
执行命令行 bundle install 来安装主题。
最后, 向您站点的 _config.yml 中加入下列代码来启用主题

10、无序列表

* `/_layouts`
* `/_includes`
* `/_sass`

/_layouts
/_includes
/_sass