开博后写过一篇Introduction to markdown,给出了几个介绍markdown的教程。这几个教程或是简明易懂,或是全面规范,可以作为很好的入门教材或查阅手册。

在实际的使用当中,我发现有些用法不是这些教程里能够找到的,或者教程里没有进行应有的强调导致使用时容易出错。本文就对这样的问题进行汇总,并会不定期更新。

  1. 删除线。

    方法:在要划删除线的文本前后添加~~

    示例:~~看《冰与火之歌》~~

    解析为: 看冰与火之歌

  2. 代码块中html代码显示不正常,<、>被解析为&gt; &lt;

    原因:markdown是一个语法规范,具体的解析可以使用不同的程序,而不同程序对规范的完成度也未必相同。hexo 所用的 marked 解析程序,无法对代码块中<、>做正确解析,需要人工矫正。

    方法:标明语言类型html

    示例:

    解析为:

  3. 有序列表。

    问题:有序列表每项中包含若干段落时,这几个列表项得不到正确解析。

    方法:在每个列表项中各段落之前加一个空格。

    示例:

1
2
3
4
5
6
7
1. foo

foo

2. bar

bar

解析为:

  1. foo

    foo

  2. bar

    bar

Comments

2013-06-06