@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$
2.2 獨(dú)立公式
$$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è),如下:
- 列表項(xiàng)
- 列表項(xiàng)
- 列表內(nèi)容
- 列表內(nèi)容
- 子列表內(nèi)容
- 子列表內(nèi)容
- 子列表內(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編輯器編輯枉证,不可切換富文本編輯器編輯。