markdown 番外篇
开博后写过一篇Introduction to markdown,给出了几个介绍markdown的教程。这几个教程或是简明易懂,或是全面规范,可以作为很好的入门教材或查阅手册。
在实际的使用当中,我发现有些用法不是这些教程里能够找到的,或者教程里没有进行应有的强调导致使用时容易出错。本文就对这样的问题进行汇总,并会不定期更新。
删除线。
方法:在要划删除线的文本前后添加
~~
示例:
~~看《冰与火之歌》~~
解析为:
看冰与火之歌代码块中html代码显示不正常,
<、>
被解析为> <
原因:markdown是一个语法规范,具体的解析可以使用不同的程序,而不同程序对规范的完成度也未必相同。hexo 所用的 marked 解析程序,无法对代码块中
<、>
做正确解析,需要人工矫正。方法:标明语言类型html
示例:
解析为:
有序列表。
问题:有序列表每项中包含若干段落时,这几个列表项得不到正确解析。
方法:在每个列表项中各段落之前加一个空格。
示例:
1 | 1. foo |
解析为:
foo
foo
bar
bar