【学习总结】Markdown 使用的正确姿势
參考資料:
Learning-Markdown 入門參考
- 注:原博可能對GitHub中的Markdown格式更適用。
- ps:在王熊貓的GitHub里也有相關格式的攻略,可一并參考學習。
關于表情的cheatsheet ? (似乎不太好,哈哈)
1、段落與換行
段落的前后必須是空行:相鄰兩行文本,如果中間沒有空行 會顯示在一行中(換行符被轉換為空格)
注:在GitHub中是這樣,博客園不是。
段落內換行:
2、標題
一種是====和---- (Setext 形式,只有兩級標題,博客園不支持)
一種是## (atx 形式,可以兩邊對稱井號或只在左邊)
常用井號
例如:
H1
====
H2
-----
3、引用
單行:行前加>
多行:每行加> 或只在第一行加后面相鄰行自動加入,如需換行,行尾加兩個空格或加一行空引用
嵌套:
注:博客園中表現并非如此,比如換行不加>,加>換行根本無效啊……
例如:
這是單行引用
這是多行引用
(如下一行這樣可以空一行)
這是嵌套引用
這是嵌套引用
4、列表
無序列表:行首寫 * 或 + 或 -,格式為“符號 空格”
有序列表:行首寫,格式為“數字+(此處空格).(空格)+后面的內容”
嵌套列表:主列表換行后縮進后加無序列表符號或有序列表符號都可以,具體如下面的例子
如需在行前顯示數字和“.”:數字. 來取消顯示為列表
例如:
- 這是無序列表一
- 這是無序列表二
- 這是無序列表三
1 . 主列表一(這里如果數字后不加空格,和上面的連著編號了;數字后加空格,重新開始編號)
+ 嵌套列表1.1
+ 嵌套列表1.2
2 . 主列表二
1. 2.1
2. 2.2
05. 按自己規定顯示列表數字
5、代碼
代碼塊:(然而并沒有卵用,直接每行空格就引用為變色代碼塊了)
// Tab開頭 Markdown// 四個空格開頭
<html> // Tab開頭 <title>Markdown</title> </html> // 四個空格開頭行內代碼:通過 “兩個點” code ,插入行內代碼(兩個點的點 ``code是 Tab 鍵上邊、數字 1 鍵左側的那個按鍵)
(這個很強)
<title>Markdown</title>
6、分割線
在行與行之間添加三個及以上的 * 、- 或 _ ,各個符號之間可以有多個空格
注:分割線與文字行需要空行否則不顯示為分割線
注:下劃線比較實在,畫多長就顯示多長……
例如:
第一行
第二行
第三行
_____
第四行
7、超鏈接
行內鏈接: 格式為 link text
注:普通鏈接就夠用了,后兩個暫時感覺很雞肋
① 普通鏈接:Google
② 指向本地文件的鏈接:icon.png
③ 包含 'title' 的鏈接:Google title 使用 ' 或 " 都是可以的
8、圖片
插入圖片的語法和插入超鏈接的語法基本一致,只是在最前面多一個 !。也分為行內式和參考式兩種。
Markdown 不支持指定圖片的顯示大小,不過可以通過直接插入標簽來指定相關屬性(不太會)
一般是直接復制圖片然后粘貼到編輯位置即可,暫時沒有發現批量上傳圖片的方法,寫作業時無法批量上傳截圖的痛記憶猶新。。
9、加粗vs斜體
1 . 使用 * * 或 _ _ 包括的文本會被轉換為 ,通常表現為斜體:
例如:這是用來 演示 的 文本
2 . 使用 ** ** 或 __ __ 包括的文本會被轉換為 ,通常表現為加粗:
例如:這是用來 演示 的 文本
3 . 用來包括文本的 * 或 _ 內側不能有空白,否則 * 和 _ 將不會被轉換(不同的實現會有不同的表現):
例如: 這是用來 * 演示* 的 文本
4 . 如果需要在文本中顯示成對的 * 或 _,可以在符號前加入 反斜杠符號 “” 即可:
例如: 這是用來 *演示* 的 _文本_
5 . *、**、_ 和 __ 都必須 成對使用 。
10、字符轉義
原博沒說明白,可能是轉換符號原有功能的意思,比如反斜杠。貼圖如下:
擴展語法如下:
1、刪除線-前后加兩個波浪符號
例如:這就是 刪除線
2、代碼塊和語法高亮
代碼塊:單獨成行的兩組三個左上角點包含多行代碼
例如:
<p>code here</p> <p>code here</p> <p>code here</p> window.addEventListener('load', function() {console.log('window loaded'); });當然,用縮進依然管用,不過代碼多的話,用點點比較省事,少量代碼可以縮進。不是一個空格,是tab
PS:縮進的方法,代碼塊不自動分開,換行無卵用。如需分開代碼塊,用點點的方法比較好。
語法高亮(然而似乎并沒有卵用……和用以上的方法的效果無差別)
在上面的代碼塊語法基礎上,在第一組 ``` 之后添加代碼的語言,如 'javascript' 或 'js',即可將代碼標記為 JavaScript
例如:
window.addEventListener('load', function() {console.log('window loaded'); });3、表格
單元格和表頭
使用 | 來分隔不同的單元格,使用 - 來分隔表頭和其他行:
例如:(此處最好空一行不然不顯示了)
| LearnShare | 12 |
| Mike | 32 |
為了美觀可以這樣:(顯示效果無差別,只是Markdown編寫的時候看著更規整)
| LearnShare | 12 |
| Mike | 32 |
對齊
在表頭下方的分隔線標記中加入 :,即可標記下方單元格內容的對齊方式:
:--- 代表左對齊
:--: 代表居中對齊
---: 代表右對齊
例如:
| aaaa | bbbbbb | ccccc |
| a | b | c |
如果不使用對齊標記,單元格中的內容默認左對齊;表頭單元格中的內容會一直居中對齊(不同的實現可能會有不同表現)。
插入其他內容:
表格中可以插入其他 Markdown 中的行內標記:
例如:
| LearnShare | 12 | LearnShare |
| Mike | 32 | Mike |
4、Task List
原博沒有寫任何說明文字,不太懂,感覺和前一部分的第4項,列表 的功能差不多。
例如:
- [ ] Eat
- [x] Code
- [x] HTML
- [x] CSS
- [x] JavaScript - [ ] Sleep
后續
后續部分
其一,介紹了當前比較熱門的Markdown編輯器
其二,介紹了轉換為HTML,PDF,Word的格式轉換。
此處不贅述,詳情見原博。
The End
- 注:其他---句子內的代碼:
<div> ; <something >
轉載于:https://www.cnblogs.com/anliux/p/8010693.html
總結
以上是生活随笔為你收集整理的【学习总结】Markdown 使用的正确姿势的全部內容,希望文章能夠幫你解決所遇到的問題。
- 上一篇: 解决Ubuntu下pycharm无法输入
- 下一篇: 修改硬件信息小工具