Markdown代码块

来自泡泡学习笔记
跳到导航 跳到搜索

预格式化的代码块用于编写关于编程或标记源代码的内容。代码块的各行被原样解释,而不是形成正常的段落。Markdown将代码块包装在<pre>和<code>标签中。


要在Markdown中生成代码块,只需将代码块的每一行缩进至少4个空格或1个制表符。例如,给定以下输入:


这是一个普通段落:

    这是一个代码块。

Markdown代码块-1.png


Markdown将生成:

<p>这是一个普通段落:</p>

<pre><code>这是一个代码块。
</code></pre>


代码块的每一行都会减少一级缩进-4个空格或1个制表符。例如,下面的代码:

这是一个AppleScript示例:

    tell application "Foo"
        beep
    end tell

Markdown代码块-2.png


将变成:

<p>这是一个AppleScript示例:</p>

<pre><code>tell application "Foo"
    beep
end tell
</code></pre>


代码块会一直持续到达一个未缩进的行(或文章的末尾)为止。


在代码块中,符号&和尖括号<和>会自动转换为HTML实体。这使得使用Markdown包含示例HTML源代码非常容易-只需粘贴并缩进它,Markdown将处理编码符号&和尖括号的麻烦。例如,下面的代码:

    <div class="footer">
        &copy;
    </div>

Markdown代码块-3.png


将变成:

<pre><code><div class="footer">
    &copy;
</div>
</code></pre>


代码块内部不会处理常规的Markdown语法。例如,在代码块中,星号只是字面上的星号。这意味着使用Markdown来编写关于Markdown自身语法的内容也很容易。