2021-06-25

@toc

Guide

這是一篇講解如何正確使用鴻蒙技術(shù)社區(qū)-Markdown的排版示例,希望通過此烂瘫,大家都能輕松上手魏滚,都能通過Markdown 能夠讓自己的文章有更加出色籍救、清晰明了的排版邻寿。

什么是 Markdown

Markdown (MD) 是現(xiàn)在普遍使用的一種文檔書寫語言格式,只需用一些非常簡單易記的符號涮雷,如(# * / > [] ()\ )阵面,就可以輕松寫出一篇具有良好的排版和可讀性的文章。

語法示例

1.基本語法

一些常規(guī)的語法格式洪鸭。

1.1 標(biāo)題

標(biāo)題用#+空格表示样刷,不同數(shù)量的#可以表示不同的標(biāo)題
# Heading 1
## Heading 2
### Heading 3
#### Heading 4
##### Heading 5
###### Heading 6

1.2 粗體和斜體粗體

在需要操作的文字前后各加三個(gè)“
這個(gè)是粗體斜體:在需要斜體的文字前后各加一個(gè)“

這個(gè)是斜體用粗體加斜體:在需要操作的文字前后各加三個(gè)“這個(gè)是粗體加斜體*

1.3 刪除線刪除線語法

在需要?jiǎng)h除的文字前后各使用兩個(gè)符合“要?jiǎng)h除的文字~~

1.4 引用

符號“>”后面書寫文字。示例:

這個(gè)是引用

1.5 目錄

可通過:@[toc](目錄) 生成目錄览爵。

1.6 空行

如需空行置鼻,則可 +回車換行。

2.LaTeX公式

LaTeX數(shù)學(xué)公式有兩種:行中公式和獨(dú)立公式(行間公式)蜓竹。行中公式放在文中與其它文字混編箕母,獨(dú)立公式單獨(dú)成行。

2.1 行內(nèi)公式

$E=mc^2$
E=mc^2

2.2 獨(dú)立公式

$$E=mc^2$$
E=mc^2

2.3 復(fù)雜公式

$$\begin{array}{c}
 
\nabla \times \vec{\mathbf{B}} -\, \frac1c\, \frac{\partial\vec{\mathbf{E}}}{\partial t} &
= \frac{4\pi}{c}\vec{\mathbf{j}}    \nabla \cdot \vec{\mathbf{E}} & = 4 \pi \rho \\
 
\nabla \times \vec{\mathbf{E}}\, +\, \frac1c\, \frac{\partial\vec{\mathbf{B}}}{\partial t} & = \vec{\mathbf{0}} \\
 
\nabla \cdot \vec{\mathbf{B}} & = 0
 
\end{array}$$

$$
\begin{array}{c}

\nabla \times \vec{\mathbf{B}} -, \frac1c, \frac{\partial\vec{\mathbf{E}}}{\partial t} &
= \frac{4\pi}{c}\vec{\mathbf{j}} \nabla \cdot \vec{\mathbf{E}} & = 4 \pi \rho \

\nabla \times \vec{\mathbf{E}}, +, \frac1c, \frac{\partial\vec{\mathbf{B}}}{\partial t} & = \vec{\mathbf{0}} \

\nabla \cdot \vec{\mathbf{B}} & = 0

\end{array}
$$

更多語法參考:《鴻蒙技術(shù)社區(qū)-Markdown 編輯器添加 Latex數(shù)學(xué)公式教程》

3.代碼高亮

3.1 普通

*emphasize*    **strong**
_emphasize_    __strong__
@a = 1

3.2 語法高亮支持

如果在 ``` 后面跟隨語言名稱俱济,可以有語法高亮的效果嘶是,如:

3.2.1 html/xml 代碼高亮示例
<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <meta http-equiv="X-UA-Compatible" content="IE=edge">
    <meta name="viewport" content="width=device-width, initial-scale=1.0">
    <title>Document</title>
</head>
<body>  
</body>
</html>
3.2.2 Python高亮示例
#!/usr/bin/python3
# Fibonacci series: 斐波納契數(shù)列
# 兩個(gè)元素的總和確定了下一個(gè)數(shù)
a, b = 0, 1
while b < 10:
    print(b)
    a, b = b, a+b
3.2.3 CSS 文件示例
body {
    background-color: red;
}

h1 {
    color: orange;
    text-align: center;
}

p {
    font-family: "Times New Roman";
    font-size: 20px;
}

支持語言有: HTML/XML, JSON, Bash, CSS, Java, JavaScript, PHP, Python, Rust, C/C++

4.繪制表格

| Column 1 | Column 2 | Column 3 |
| -------- | -----: | :----: |
| cell 1 | cell 2 | cell 3 |
| cell 4 | cell 5 | cell 6 |
| cell 7 | cell 8 | cell 9 |

Column 1 Column 2 Column 3
cell 1 cell 2 cell 3
cell 4 cell 5 cell 6
cell 7 cell 8 cell 9

5.Todo列表

語法:

- [ ] 社區(qū)直播公開課開展情況
- [x] 5分鐘搞定俄羅斯方塊---組件化實(shí)戰(zhàn)
- [x] HarmonyOS應(yīng)用服務(wù)早期紅利與各項(xiàng)技術(shù)場景創(chuàng)新分析
- [ ] 從萌新到高手——怎樣快速掌握鴻蒙開發(fā)

顯示:

  • 社區(qū)直播公開課開展情況
  • 5分鐘搞定俄羅斯方塊---組件化實(shí)戰(zhàn)
  • HarmonyOS應(yīng)用服務(wù)早期紅利與各項(xiàng)技術(shù)場景創(chuàng)新分析
  • 從萌新到高手——怎樣快速掌握鴻蒙開發(fā)

6.鏈接

支持直接粘貼鏈接地址。鏈接語法和顯示如下:
語法1:[鏈接名稱](http://鏈接網(wǎng)址)
顯示:鏈接名稱
或語法2:<http://鏈接網(wǎng)址>
顯示:http://鏈接網(wǎng)址

7. 圖片

可通過上傳按鈕上傳圖片蛛碌,也支持直接粘貼圖片聂喇,也支持拖拽上傳圖片。圖片語法和顯示如下:
語法:[圖片上傳失敗...(image-b295fa-1624621258619)]
顯示:![請?zhí)砑渔溄用枋鯹(圖片地址)

8. 有序列表&有序列表

無序列表的使用左医,在符號“-”后加空格使用授帕。如下:

  • 列表項(xiàng)
  • 列表項(xiàng)
  • 列表項(xiàng)

如果要控制列表的層級,則需要在符號“-”前使用空格浮梢。如下:

  • 列表項(xiàng)
  • 列表項(xiàng)
    • 列表內(nèi)容
    • 列表內(nèi)容

有序列表的使用跛十,在數(shù)字及符號“.”后加空格幾個(gè),如下:

  1. 列表項(xiàng)
  2. 列表項(xiàng)
    1. 列表內(nèi)容
    2. 列表內(nèi)容
      1. 子列表內(nèi)容
      2. 子列表內(nèi)容
      3. 子列表內(nèi)容

9. 分割線

可以在一行中用三個(gè)以上的星號秕硝、減號芥映、底線來建立一個(gè)分隔線,同時(shí)需要在分隔線的上面空一行远豺。
例:
-------
*****
______




10. 符號轉(zhuǎn)義

如果你的描述中需要用到 markdown 的符號奈偏,比如 # * 等,但又不想它被轉(zhuǎn)義躯护,這時(shí)候可以在這些符號前加反斜杠惊来,如 \ # *進(jìn)行避免。

11. 導(dǎo)入和導(dǎo)出

支持正文導(dǎo)出.md的文檔棺滞,支持導(dǎo)入.md格式的文檔裁蚁。
導(dǎo)入:支持導(dǎo)入本地 .md格式的文檔
導(dǎo)出:正文內(nèi)容可以導(dǎo)出本地.md格式的文檔

12. 其他說明

使用富文本編輯器發(fā)布的內(nèi)容只能富文本編輯器編輯,不可切換Markdown編輯器继准;
使用Markdown編輯器發(fā)布的內(nèi)容只能Markdown編輯器編輯枉证,不可切換富文本編輯器編輯。

?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請聯(lián)系作者
  • 序言:七十年代末移必,一起剝皮案震驚了整個(gè)濱河市室谚,隨后出現(xiàn)的幾起案子,更是在濱河造成了極大的恐慌崔泵,老刑警劉巖秒赤,帶你破解...
    沈念sama閱讀 218,941評論 6 508
  • 序言:濱河連續(xù)發(fā)生了三起死亡事件,死亡現(xiàn)場離奇詭異憎瘸,居然都是意外死亡倒脓,警方通過查閱死者的電腦和手機(jī),發(fā)現(xiàn)死者居然都...
    沈念sama閱讀 93,397評論 3 395
  • 文/潘曉璐 我一進(jìn)店門含思,熙熙樓的掌柜王于貴愁眉苦臉地迎上來崎弃,“玉大人,你說我怎么就攤上這事含潘∷亲觯” “怎么了?”我有些...
    開封第一講書人閱讀 165,345評論 0 356
  • 文/不壞的土叔 我叫張陵遏弱,是天一觀的道長盆均。 經(jīng)常有香客問我,道長漱逸,這世上最難降的妖魔是什么泪姨? 我笑而不...
    開封第一講書人閱讀 58,851評論 1 295
  • 正文 為了忘掉前任游沿,我火速辦了婚禮,結(jié)果婚禮上肮砾,老公的妹妹穿的比我還像新娘诀黍。我一直安慰自己,他們只是感情好仗处,可當(dāng)我...
    茶點(diǎn)故事閱讀 67,868評論 6 392
  • 文/花漫 我一把揭開白布眯勾。 她就那樣靜靜地躺著,像睡著了一般婆誓。 火紅的嫁衣襯著肌膚如雪吃环。 梳的紋絲不亂的頭發(fā)上,一...
    開封第一講書人閱讀 51,688評論 1 305
  • 那天洋幻,我揣著相機(jī)與錄音郁轻,去河邊找鬼。 笑死文留,一個(gè)胖子當(dāng)著我的面吹牛范咨,可吹牛的內(nèi)容都是我干的。 我是一名探鬼主播厂庇,決...
    沈念sama閱讀 40,414評論 3 418
  • 文/蒼蘭香墨 我猛地睜開眼渠啊,長吁一口氣:“原來是場噩夢啊……” “哼!你這毒婦竟也來了权旷?” 一聲冷哼從身側(cè)響起替蛉,我...
    開封第一講書人閱讀 39,319評論 0 276
  • 序言:老撾萬榮一對情侶失蹤,失蹤者是張志新(化名)和其女友劉穎拄氯,沒想到半個(gè)月后躲查,有當(dāng)?shù)厝嗽跇淞掷锇l(fā)現(xiàn)了一具尸體,經(jīng)...
    沈念sama閱讀 45,775評論 1 315
  • 正文 獨(dú)居荒郊野嶺守林人離奇死亡译柏,尸身上長有42處帶血的膿包…… 初始之章·張勛 以下內(nèi)容為張勛視角 年9月15日...
    茶點(diǎn)故事閱讀 37,945評論 3 336
  • 正文 我和宋清朗相戀三年镣煮,在試婚紗的時(shí)候發(fā)現(xiàn)自己被綠了。 大學(xué)時(shí)的朋友給我發(fā)了我未婚夫和他白月光在一起吃飯的照片鄙麦。...
    茶點(diǎn)故事閱讀 40,096評論 1 350
  • 序言:一個(gè)原本活蹦亂跳的男人離奇死亡典唇,死狀恐怖,靈堂內(nèi)的尸體忽然破棺而出胯府,到底是詐尸還是另有隱情介衔,我是刑警寧澤,帶...
    沈念sama閱讀 35,789評論 5 346
  • 正文 年R本政府宣布骂因,位于F島的核電站炎咖,受9級特大地震影響,放射性物質(zhì)發(fā)生泄漏。R本人自食惡果不足惜乘盼,卻給世界環(huán)境...
    茶點(diǎn)故事閱讀 41,437評論 3 331
  • 文/蒙蒙 一升熊、第九天 我趴在偏房一處隱蔽的房頂上張望。 院中可真熱鬧绸栅,春花似錦级野、人聲如沸。這莊子的主人今日做“春日...
    開封第一講書人閱讀 31,993評論 0 22
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽卷中。三九已至矛双,卻和暖如春,著一層夾襖步出監(jiān)牢的瞬間蟆豫,已是汗流浹背议忽。 一陣腳步聲響...
    開封第一講書人閱讀 33,107評論 1 271
  • 我被黑心中介騙來泰國打工, 沒想到剛下飛機(jī)就差點(diǎn)兒被人妖公主榨干…… 1. 我叫王不留十减,地道東北人栈幸。 一個(gè)月前我還...
    沈念sama閱讀 48,308評論 3 372
  • 正文 我出身青樓,卻偏偏與公主長得像帮辟,于是被迫代替她去往敵國和親速址。 傳聞我的和親對象是個(gè)殘疾皇子,可洞房花燭夜當(dāng)晚...
    茶點(diǎn)故事閱讀 45,037評論 2 355

推薦閱讀更多精彩內(nèi)容