童雷 ·Markdown 行內(nèi)代碼
1. 前言
關(guān)于行內(nèi)代碼，Markdown 作者給出的定義如下：
中文解釋：行內(nèi)代碼用一對 「反引號(hào)
`」符號(hào)將需要轉(zhuǎn)換的文字內(nèi)容包括起來，它讓我們方便地在行內(nèi)編輯帶有特殊字符的文字內(nèi)容。原文出處：daringfireball.net。
Markdown 作為一種排版工具語言，其作用是為了幫助我們處理一些常見的排版問題。但是我們?nèi)杂幸恍﹫鼍靶枰Ａ粑淖值脑袷?，例如保留字符中間的空格數(shù)量等。Markdown 通過行內(nèi)代碼的形式讓連續(xù)字符保持格式不變。
環(huán)境說明：
考慮到 Markdown 工具之間的不兼容，有的內(nèi)容直接從頁面復(fù)制粘貼到本地不會(huì)正常顯示，大家學(xué)習(xí)時(shí)自己動(dòng)手寫是肯定沒問題的。本節(jié)所有實(shí)例代碼及演示效果均使用 Typora 工具完成。
2. 語法詳解
2.1 行內(nèi)代碼
在 Markdown 文件中，使用 「反引號(hào) `」符號(hào)定義行內(nèi)代碼。
實(shí)例 1：
#### 定義行內(nèi)代碼
行內(nèi)的 html 代碼：`<head><title>網(wǎng)頁標(biāo)題</title></head>`
行內(nèi)的 json 代碼：`var json = {key: value};`
其渲染結(jié)果如下：
該源碼渲染輸出 html 的內(nèi)容如下：
<p>行內(nèi)的 html 代碼： <code><head><title>網(wǎng)頁標(biāo)題</title></head></code></p>
<p>行內(nèi)的 json 代碼：<code>var json = {key: value};</code></p>
如果需要轉(zhuǎn)換為代碼塊的內(nèi)容中，包含了不連續(xù)的 「反引號(hào) `」符號(hào)，這時(shí)可以通過連續(xù)的 「反引號(hào) ``」符號(hào)作為文字內(nèi)容的開始和結(jié)束標(biāo)記。
實(shí)例 2：
#### 定義行內(nèi)代碼包含反引號(hào)
這段代碼里包含反引號(hào) ``select `state` from user;``
渲染結(jié)果如下：
該源碼渲染輸出 HTML 的內(nèi)容如下：
<p>這段代碼里包含反引號(hào) <code>select `state` from user;</code></p>
注意「行內(nèi)代碼」開頭或結(jié)尾包含關(guān)鍵字「反引號(hào) `」時(shí)，開頭和結(jié)尾必須包含空格。
實(shí)例 3：
#### 定義行內(nèi)代碼開頭或結(jié)束包含反引號(hào)
行內(nèi)代碼的定義是由反引號(hào)開始的，形如:`` `"hello, ${}"` ``
渲染結(jié)果如下：
該源碼渲染輸出 HTML 的內(nèi)容如下：
<p>行內(nèi)代碼的定義是由反引號(hào)開始的，形如:<code>`"hello, ${}"`</code></p>
3. 使用場景及應(yīng)用實(shí)例
行內(nèi)代碼功能可以讓我們很輕松的在文章文字內(nèi)容中間增加諸如 <html> 標(biāo)簽的內(nèi)容，而不需要手動(dòng)轉(zhuǎn)義。當(dāng)我們編寫程序說明文檔時(shí)，或者其他需要在文檔中插入特殊字符時(shí)，這個(gè)功能的作用會(huì)非常明顯。
實(shí)例 4：
一些常見的符號(hào)表情。
#### 一些常見的表情符號(hào)
開心：`(⊙?⊙)` `（‐＾▽＾‐）` ` ?(?òωó?)?` `ヾ（≧?≦）〃` `o(>ω<)o` `(￣▽￣)ノ`
傷心：`(；′д｀)ゞ` `(；д；)` `(；へ：)` `(╥╯╰╥)` `╮(╯﹏╰）╭` `╭(╯╰)╮` `(╯︵╰)`
驚訝：`?????` ` (」゜ロ゜)」` `` (′⊙ω⊙`)！`` ` щ(゜ロ゜щ)` ` ?∩??ω??∩?` `?( ? w ? )?` `?? . o ?? o . ??` `(?????)、`
渲染結(jié)果如下：
4. 小結(jié)
- 定義行內(nèi)代碼的開始和結(jié)束標(biāo)記，其連續(xù)反引號(hào)數(shù)量可以由內(nèi)容中的連續(xù)反引號(hào)數(shù)量決定，例如：
` 沒有反引號(hào)的文字內(nèi)容 `，``有單個(gè)反引號(hào)`的內(nèi)容``，```有連續(xù)兩個(gè)反引號(hào)的``內(nèi)容```； - 行內(nèi)代碼之間不可以包含換行，如果需要包含換行，請參考 “代碼塊” 部分內(nèi)容。
在開發(fā)文檔或者 IT 論文中，“行內(nèi)代碼” 的使用頻率非常高，不過由于 “行內(nèi)代碼” 不能根據(jù)代碼自身的特效做語法高亮處理，所以相比 “代碼塊” 效果，“行內(nèi)代碼” 更適合用作簡短的文字說明。
2025 imooc.com All Rights Reserved |