Hello Jekyll!

2009.01.01 | Comments

目前,博客使用的是Jekyll搭建的,markdown语法使用的是Redcarpet。Redcarpet支持设置 extensions ,值为一个字符串数组,每个字符串都是 Redcarpet::Markdown 类的扩展,相应的扩展就会设置为 true 。

配置为:

highlighter: pygments
markdown: redcarpet  # [ maruku | rdiscount | kramdown | redcarpet ]

redcarpet:
    extensions:
        - fenced_code_blocks
        - no_intra_emphasis
        - strikethrough
        - autolink
        - tables
        - superscript
        - highlight
        - prettify
        - with_toc_data

redcarpet有几个扩展:

  • fenced_code_blocks 解析代码块,使用3个或3个以上 ~ 或者 ` 包围起来的文本会被解析为代码块,你可以在开头指定代码的语言类型
  • no_intra_emphasis 不解析单词中的下划线
  • strikethrough 支持两个 ~ 包围的文本,解析为删除线
  • space_after_headers #后面必须加空格,否则不会被解析为标题
  • autolink 自动检查文本中 http https ftp 等协议的链接文本,将之解析为链接。没有以 http:// 开头,而是直接以 www. 开头的同样会被检查到
  • hard_wrap 如果 Markdown 文本中有折行的话,会转换为标签
  • tables 表格
  • superscript 上标,例如 : this is the 2^(nd) time ,效果为:this is the 2^(nd) time
  • with_toc_data 给生成的 Header 标签增加锚点

升级到jekyll3之后,需要修改为kramdown:

markdown:    kramdown
highlighter: rouge

kramdown:
  input: GFM
  auto_ids:       true
  footnote_nr:    1
  entity_output:  as_char
  toc_levels:     1..6
  smart_quotes:   lsquo,rsquo,ldquo,rdquo
  enable_coderay: false
  syntax_highlighter: rouge
  hard_wrap: false

  extensions:
    - autolink
    - footnotes
    - smart
    - table

语法

标题

标题

# 测试 h1
## 测试 h2
### 测试 h3
#### 测试 h4
##### 测试 h5
###### 测试 h6

效果:

测试 h1

## 测试 h2 ### 测试 h3 #### 测试 h4 ##### 测试 h5 ###### 测试 h6

列表

无序列表:

* 项目1
* 项目2
* 项目3

效果:

  • 项目1
  • 项目2
  • 项目3

有序列表:

1. 项目1
2. 项目2
3. 项目3
   * 项目1
   * 项目2

效果:

  1. 项目1
  2. 项目2
  3. 项目3
    • 项目1
    • 项目2

粗体与斜体

文字格式:

**这是文字粗体格式**
*这是文字斜体格式*
~~在文字上添加删除线~~

效果:

这是文字粗体格式 这是文字斜体格式 在文字上添加删除线

链接与图片

自动链接

 <http://blog.javachen.com>
 <XhstormR@foxmail.com>

插入链接

 [link text](http://example.com/ "optional title")

 [link text][id]
 [id]: http://example.com/  "optional title here"

插入图片

 ![](/path/to/img.jpg "optional title"){ImgCap}alt text{/ImgCap}

图片链接

 [![][jane-eyre-pic]{ImgCap}{/ImgCap}][jane-eyre-douban]

 [jane-eyre-pic]: http://img3.douban.com/mpic/s1108264.jpg
 [jane-eyre-douban]: http://book.douban.com/subject/1141406/

代码

行代码: code

用TAB键起始的段落,会被认为是代码块,或者使用三个`或~:

/* hello world demo */
#include <stdio.h>
int main(int argc, char **argv)
{
        printf("Hello, World!\n");
        return 0;
}

表格

|head1|head2|head3|head4
|---|:---|---:|:---:|
|row1text1|row1text2|row1text3|row1text4
|row2text1|row2text2|row2text3|row2text4
|row3text1|row3text2|row3text3|row3text4
|row4text1|row4text2|row4text3|row4text4

效果:

head1 head2 head3 head4
row1text1 row1text2 row1text3 row1text4
row2text1 row2text2 row2text3 row2text4
row3text1 row3text2 row3text3 row3text4
row4text1 row4text2 row4text3 row4text4

引用

> 第一行引用文字
> 第二行引用文字

第一行引用文字 第二行引用文字

水平线

***

参考资料


原创文章,转载请注明: 转载自JavaChen Blog,作者:JavaChen
本文链接地址:http://blog.javachen.com/2009/01/01/hello-jekyll.html
本文基于署名2.5中国大陆许可协议发布,欢迎转载、演绎或用于商业目的,但是必须保留本文署名和文章链接。 如您有任何疑问或者授权方面的协商,请邮件联系我。