markdown
基本知識
markdown
是一種簡化的 html
語法,相比於 txt
無格式文字更強大.
你可以用專門的軟體去編輯 markdown
檔案,就像需要使用軟體編輯 txt
檔案一樣,當然也可以什麼軟體也不用,甚至直接在記事本或命令列書寫,只不過這樣的缺點就是無法實時預覽輸出效果,安全依賴個人經驗和想象力了.
markdown
檔案字尾名是.md
,安裝了相應外掛的瀏覽器或專門軟體能夠看到輸出效果.
標題
語法格式:
#
+空格
+文字
大多數markdown
編輯器支援 h1~h6
級標題,而富文字編輯器一般僅支援到二級標題.
示例:
# 標題1
## 標題2
複製程式碼
效果:
標題1
標題2
列表
列表包括有序列表,無序列表和任務列表,並支援列表巢狀.
大多數 markdown
編輯器和富文字編輯器均支援有序列表和無序列表,而任務列表和列表巢狀支援度就不是很好,存在平臺相容性問題.
有序列表
語法格式:
數字
+.
+空格
+文字
示例:
1. 有序列表1
2. 有序列表2
3. 有序列表3
複製程式碼
效果:
- 有序列表1
- 有序列表2
- 有序列表3
無序列表
語法格式:
- 或 * 或 +
+空格
+文字
示例:
- 無序列表1
* 無序列表2
+ 無序列表3
複製程式碼
效果:
- 無序列表1
- 無序列表2
- 無序列表3
連結和圖片
markdown
編輯器和富文字編輯器均支援連結和圖片,值得注意的是有些平臺限制或禁止外鏈.
連結
語法格式:
[顯示文字]
+(連結地址)
示例:
[https://snowdreams1006.github.io](https://snowdreams1006.github.io/)
複製程式碼
效果:
圖片
語法格式:
!
+[圖片標題]
+(圖片地址)
示例:
![雪之夢技術驛站的頭像](https://avatars0.githubusercontent.com/u/23238267?s=400&u=c60a9628495b4bfb4c6ee1a7bba8e3a8d265ca96&v=4)
複製程式碼
效果:
程式碼
程式碼分為單行程式碼和多行程式碼,其中多行程式碼也叫做程式碼塊.
大多數 markdown
編輯器均支援程式碼,富文字編輯器支援度不一樣,有的支援單行程式碼有的支援程式碼塊.
單行程式碼
語法格式:
`
+單行程式碼
+`
示例:
`code`
複製程式碼
效果:
code
多行程式碼
語法格式:
```
+多行程式碼
+```
示例:
``` function fun(){ echo "這是一句非常牛逼的程式碼"; } fun(); ```
效果:
function fun(){
echo "這是一句非常牛逼的程式碼";
}
fun();
複製程式碼
這裡的富文字支援語法指的是
markdown
渲染後的內容能否正常顯示,並不是指markdown
語法本身能夠正常渲染,更多詳情請參考 markdown 快速入門
git
基本知識
git
是全世界最先進的分散式版本控制系統,幫助專案更好地進行管理,支援版本歷史管理和多人寫作管理等功能.
簡單地說,可以理解為一種優雅的文件備份方式,支援雲端備份,多人協作等特點.
初始化專案
語法格式:
git init
適合從零開始的本地專案,初始化後的專案才是能夠被 git
管理的專案.
示例:
git init
複製程式碼
克隆專案
語法格式:
git clone
適合已有遠端專案需要下載到本地,作用是將遠端專案克隆到本地,和 git init
實現類似的功能.
示例:
git clone git@github.com:username/username.github.io.git
複製程式碼
新增檔案
語法格式:
git add
將檔案新增到暫存區,支援多次新增檔案,相當於寫入快取區.
示例:
git add .
複製程式碼
提交檔案
語法格式:
git commit
將暫存區內容提交到版本庫,完成一次歷史版本.
示例:
git commit -m "寫入提交備註,簡短說明下提交意圖和目標"
複製程式碼
推送檔案
語法格式:
git push
將本地版本庫推送到遠端版本庫,相當於本地檔案備份到雲端伺服器.
示例:
git push origin master
複製程式碼
拉取檔案
語法格式:
git pull
將遠端版本庫拉取到本地版本庫,相當於雲端伺服器檔案恢復到本地.
示例:
git pull
複製程式碼
檢視狀態
語法格式:
git status
檢視當前檔案狀態,包括檔案被新增,被修改,被刪除,未提交等等.
示例:
git status
複製程式碼
比較差異
語法格式:
git diff
檢視兩個檔案之間的具體差異
示例:
git diff
複製程式碼
歷史日誌
語法格式:
git log
檢視版本庫的提交歷史日誌
示例:
git log
複製程式碼
上述僅介紹了
git
的簡單命令,實際使用情況遠不止這些,更多詳情請參考 git 入門教程