Markdown codeblocks and indented paragraphs

本文有 627 字,大约需要 1 分钟可以读完, 创建于 2012-03-03

错落的格式

Markdown是一种很简单灵活的标记工具,其语法在官方文档里边有很详细的描述。不过我在使用其语法进行markup的时候发现段落缩进和codeblock同时使用的时候,有些奇怪的行为。如果希望下一个子段落保持缩进并且同时放置一个代码块,则格式可能就变混乱起来。譬如:

- Test title
    test indented paragraph, with some ruby code
        
        puts "hello"

将产生如下的输出:


Test title

test indented paragraph, with some ruby code
    
    puts "hello" ------------------

上述输出中,子段落部分显然不是我们希望的codeblock。

问题解决方法

看了文档后,想到了一种workaround: 在将要缩进的子段落的前一行最后加2个额外的空格,即可避免下边的子段落被当作codeblocks。

下边是修改后的效果 - (Test title之后加入2个以上空格字符)


  • Test title
    Test indented paragraph, with some ruby code
    puts “hello”

    Another sub paragraph

    A third paragraph

限制和问题

测试表明,以上方法仅仅对list的子段落有用。

Categories: ,

Updated:

Leave a Comment

Your email address will not be published. Required fields are marked *

Loading...