一、行内代码
使用一对反引号(`
)来创建行内代码。
如果在行内代码中需要包含反引号本身,可以使用两个反引号对加前后空格来创建。(但是这样的代码块不会进行语法高亮,只是简单地将代码以等宽字体显示)
注:反引号在键盘上位于左上角,数字1键的右边、Esc键的下方。在英文输入法下,直接按这个键,打出来的就是反引号( ` );shift+这个键打印出的是波浪号(~);
Markdown | HTML | 预览 |
---|---|---|
这是行内`代码` | <p>这是行内<code>代码</code></p> | 这是行内代码 |
`` ` `` | <code>`</code> | ` |
markdown的形式输入:
HTML渲染后输出:
二、代码块
将文本的每一行缩进至少四个空格或一个制表符。这样这些文本会变成代码块。(这样的代码块也会被渲染为等宽字体,但不会进行语法高亮。)
markdown的形式输入:
HTML渲染后输出:
三、围栏式代码块
在很多 Markdown 解析器里都支持使用三个反引号(`
)或三个波浪号(~
)来定义围栏式代码块。同时这种代码块配合插件还可以做到代码高亮、行号等高级功能。
注意: 下面的代码有高亮显示效果,但这并不是 Markdown 本身的功能,而是通过第三方插件
Prism.js
做到的。一般在开始的三个反引号或波浪号的后面加代码语言可以指定代码的语言从而可以使用第三方插件做到高亮效果。
markdown的形式输入:
HTML渲染后输出:
如果在代码块中也存在三个反引号或波浪号,可以在外层使用 4 个。
如下图:
四、注意事项:
在使用Markdown的代码块时,有一些值得注意的地方:
1. 语言指定:如果你希望代码块进行语法高亮显示,可以在三个反引号后面指定代码的语言。这样可以提高代码的可读性和可理解性。然而,并不是所有的Markdown解析器都支持语言指定,所以在选择语言时需要注意。
2. 缩进:使用缩进来创建代码块时,需要注意缩进的一致性。代码块中的每行代码都应该有相同的缩进,通常是四个空格或一个制表符。如果缩进不一致,可能会导致代码块显示异常。
3. 转义字符:在代码块中,某些字符可能具有特殊的Markdown语法含义,比如星号(*)和下划线(_)。如果你希望这些字符在代码块中显示为普通字符,而不是Markdown的标记符号,可以使用转义字符(反斜杠)进行转义,例如:`\*`。
4. 代码格式:在代码块中,通常会使用等宽字体来显示代码。这样可以保持代码的格式和缩进。如果你希望在代码块中显示特殊的格式,比如粗体或斜体,可以使用Markdown的标记符号,如双星号(**)和单星号(*)。
5. 行号:Markdown的代码块默认不会显示行号。如果你希望在代码块中显示行号,可以使用一些Markdown扩展来实现,比如使用`{linenos}`参数来指定显示行号。
总的来说,使用Markdown的代码块需要注意语言指定、缩进一致性、转义字符、代码格式和行号等方面。正确地使用这些功能可以使代码块更加清晰、易读和易理解。
今天是第五天啦,距离十天之期还剩下一半,但这一半往往最能看出一个人的坚持,是要半途而废,还是坚持奋斗,都取决于你自己。在这个科技、经济飞速发展的时代,进步缓慢也算是失败,更何况停滞不前呢?当然,如果你真的因为某些原因无法坚持下去,那么或许你的放弃将成就更多的人。反之,只要我们定下一个目标,跨出第一步,日积月累,就能逐渐把我们的目标完成。人生不止有大成功,还有许许多多的小超越,量变迟早带来质变,可能是一个瞬间的小确幸,可能是一个不起眼的小改变,但却给了我们无限的力量,指引我们继续......学下去......
呈以此言,与诸君共勉之!