第06节 Markdown代码块

2018-08-09 15:16 更新

  代码块用以呈现须原样输出的文本。

  代码块有两种,一种在行内,另一种可以跨行。

  行内代码块编译后会被 Html 的 <code></code>标签对包围;而跨行代码块会被编译到<pre><code></pre></code>标签对中。

行内代码块

  行内代码块以两个`字符(即通常在Esc键下方的波形符键上的反引号字符)包围。

  例如下面这行 Markdown 文本:

这是一小段`代码`。
常常可以用来描述某种快捷键,例如`Ctrl+F`。

  编译为 Html 后会呈现为下面这个样子:

这是一小段代码

常常可以用来描述某种快捷键,例如Ctrl+F

  行内代码块最大的用处是用来制作填空题!

行内代码块的快速输入

  选定需要使用一对反引号包围的文本,按下Ctrl+`组合快捷键,即可自动添加两个反引号。

  不选中任何文本,直接按Ctrl+`,会自动添加一对反引号,并将插入点光标定位到两个反引号中间。此时可以直接输入文本。输入文本后,按Tab键,会自动跳过尾反引号,这样就可以接着输入了。

多行代码块

也可以添加多行代码文本,每行都需要以至少四个半角空格(或以至少一个Tab符)开头。

例如:下面以“□”表示一个半角英文空格,以“[Tab]”表示一个Tab字符:

□□□□function DeleteText()□□  
□□□□{□□  
□□□□□□□□string s = "示例文本";□□  
□□□□□□□□...□□  
□□□□□□□□ClipBoard.Delete();□□  
□□□□}□□  
[Tab]function DeleteImage()□□  
[Tab]{□□  
[Tab][Tab]Image img = new Image();□□  
[Tab][Tab]...□□  
[Tab][Tab]ClipBoard.Delete();□□  
[Tab]}□□  

转译后会显示为:

function DeleteText()  
{  
    string s = "示例文本";  
    ...  
    ClipBoard.Delete();  
}  
function DeleteImage()  
{  
     Image img = new Image();  
     ...  
     ClipBoard.Delete();  
}  

代码块与其它元素的冲突

  很多元素——例如引用文本块、有序列表、无序列表……它们不需要顶格书写——可以在它们前面存在[1,3]个引导空格。但一旦空格数量达到 4 个,立即就会变成代码块。例如下面这些:

□□□□> 看起来是个引用,其实会被原样输出为代码行
□□□□~看起来是个页眉,其实还是代码行
□□□□%看起来是文档标题,也是代码行
□□□□+ 看起来是无序列表,其实是代码行
□□□□1. 看起来是有序列表,其实是代码行

  上面的“□”表示一个半角英文空格。这几行编译成 Html 后显示为:

> 看起来是个引用,其实会被原样输出为代码行
~看起来是个页眉,其实还是代码行
%看起来是文档标题,也是代码行
+ 看起来是无序列表,其实是代码行
1. 看起来是有序列表,其实是代码行

  而如果前导空格只有 3 个,情况立马就变得不一样。

以上内容是否对您有帮助:
在线笔记
App下载
App下载

扫描二维码

下载编程狮App

公众号
微信公众号

编程狮公众号