MarkDown在VSCode环境下使用
目錄
1.MarkDown簡介
2.VSCode簡介(Visual Studio Code)
3.VSCode中的MarkDown環境
4.MarkDown相關操作與常用語法
(1)創建新.md文件
(2)標題
(3)換行與分段
(4)強調(加粗與斜體)
(5)列表(有序&無序)?
(6)插入圖片
(7)數學公式
(8)表格
(9)鏈接
(10)代碼塊
(11)分割線
(12)引用
(13)流程圖
(14)目錄
(15)md文件導出為其他文件
1.MarkDown簡介
Markdown 是一種輕量級標記語言,一個運行于?Mac OS X、Windows和?Linux?之上的,針對于編寫現代Web和云應用的跨平臺源代碼編輯器
Markdown文件后綴名為 .md
? ? ? ? 優點:
- 輕量化、易讀易寫
- 對于圖片,圖表、數學式都有支持
- 許多網站都廣泛使用 Markdown 來撰寫文檔
- 使用標記語言語法編排文檔,簡潔明了
- Markdown可以快速轉化為演講PPT、Word、PDF等產品文檔
- 可用于編寫說明文檔,以“README.md”的文件名保存在軟件的目錄下面
2.VSCode簡介(Visual Studio Code)
Visual Studio Code(簡稱“VS Code”)是Microsoft在2015年4月30日Build開發者大會上正式宣布一個運行于?Mac OS X、Windows和?Linux?之上的,針對于編寫現代Web和云應用的跨平臺源代碼編輯器
不僅僅是源代碼編輯器,Visual Studio Code已經成為當前最熱門的文本編輯器。
? ? ? ? 優點:
- 跨平臺
- 開源
- 簡易
- 可擴展,插件豐富
- 輕量快捷
3.VSCode中的MarkDown環境
需先安裝VSCode
在VSCode插件商店中搜索并安裝以下插件:
- Markdown All in One? ?——提供豐富的Markdown相關的快捷鍵、自動補全功能,提高md文檔編寫生產力
- Markdown Preview Ehanced? ?——用于渲染當前編寫文檔的效果同步預覽
- Paste Image? ?——用于快速引用圖片至Markdown文檔
????????注意:安裝完Markdown Preview Ehanced?可能會發生markdown換行相關語法錯誤以下為解決辦法:
下載好所有插件重啟生效后,需要修改一下設置,點擊左下角齒輪按鈕,在搜索框中輸入break,將搜索選項中的Markdown Preview Ehanced:Break On Single New Line取消勾選。
以下為取消勾選操作完成圖:
4.MarkDown相關操作與常用語法
(1)創建新.md文件
在左側文件夾內創建新的文件并后綴命名為.md,并點擊右上角預覽按鈕同步渲染文本效果
(2)標題
在想要設為標題的文本前進加井號“#”,一級標題加1個“#”,二級加2個,最多為6級
正文則直接寫就好
效果如下:
(3)換行與分段
在MD中,回車并不能換行,只是將文字加個空格,如下左側編輯器中回車換行,但右側渲染出來的效果只是空了一格:
?想要換行需要在上一行后面加兩個空格再回車
如果要新起一段,則打兩個回車
(4)強調(加粗與斜體)
斜體:在文本兩端各加1個星號”*“? ? ? ? 快捷鍵:ctrl + i
加粗:在文本兩端各加2個星號”*“? ? ? ? 快捷鍵:ctrl + b
?
(5)列表(有序&無序)?
有序列表:輸入1.加一個空格(注意有點”.“),按回車會自動補全編號
如果要輸入分級列表,回車并刪除新生成的序列號并再次輸入1.空格
如果要加入新的列表則在兩個列表之間新起一段,或者添加文字
無序列表:輸入星號"*"加空格或者加號"+"加空格或者減號"-"加空格
(6)插入圖片
復制所需圖片,在所需插入圖片位置按下快捷鍵ctrl+alt+v(不是ctrl+v噢),效果如下:
或者手動把圖片加入md文件所在文件夾下,輸入 
(7)數學公式
以下采用latex排版方式對數學公式進行演示,數學公式以 ”\“ 起始
行內展示數學公式:用1個$$括起來? ? ? ? ? ? 快捷鍵:ctrl+m
另起一段展示數學公式:用兩個$$括起來? ?快捷鍵:連按兩下ctrl+m
?
(8)表格
第一行是表頭以”|“區分列
第二行是對齊方式,?"-"表示默認對其即左對齊,在"-"左側加":"為左對齊,在右側加":"為右對齊,兩邊都加":"為劇中對齊("-"的個數可隨便寫,按照自己的喜好對齊即可,冒號一定要是英文字符!!!)
?按下alt+shift+f 可格式化文本編排,效果如下:
(9)鏈接
復制鏈接ctrl+v黏貼
直接黏貼則直接生成可點擊的鏈接
選中文字黏貼則生成可點擊的文字按鈕鏈接
(10)代碼塊
用兩行"```"括起來,鍵盤左上方Tab鍵上方的點號,英文輸入法下輸入!!
在第一行"```"后輸入所用語言名字可指定語言提供高亮,如:
```javascript
```
(11)分割線
在所需添加分割線的文本下新起一行輸入三個減號 "---"
(12)引用
?在引用的文字前加上大于號">",如下:
(13)流程圖
運用flowchart.js語法
基本語法:tag=>type: content:>url
- tag????????元素名字,可自定義
- type??????元素類型
- url? ? ? ? ?引用的鏈接,點擊相應元素可出發鏈接
注意:冒號和名稱之間需要有一個空格
相關元素類型:
- 開始(橢圓形):start
- 結束(橢圓形):end
- 結束(橢圓形):end
- 多輸出操作(矩形):parallel
- 條件判斷(菱形):condition
- 輸入輸出(平行四邊形):inputoutput
- 預處理/子程序(圣旨形):subroutine
- content就是在框框中要寫的內容,注意type后的冒號與文本之間一定要有個空格。
- url是一個連接,與框框中的文本相綁定
關鍵字
- yes/true:condition類型變量連接時,用于分別表示yes條件的流向
- no/false:同上,表示否定條件的流向
- left/right:表示連線出口在節點位置(默認下面是出口,如op3),可以跟condition變量一起用:cond(yes,right)
- path1/path2/path3:parallel變量的三個出口路徑(默認下面是出口)
節點狀態
??為節點設置不同的狀態,可以通過不同的顏色顯示,其中狀態包括下面6個,含義如英文所示,
- past
- current
- future
- approved
- rejected
- invalid
以下是示例:
```flow st=>start: 開始 e=>end: 結束 tag1=>operation: 任務1 tag2=>operation: 任務2 cond1=>condition: 是否進行任務2st->tag1(right)->cond1 cond1(no)->tag1 cond1(yes)->tag2 tag2->e ```(14)目錄
在要生成目錄的地方輸入 [TOC] ,markdown或根據分級標題自動生成目錄
?
(15)md文件導出為其他文件
點擊markdown preview ehanced提供的渲染預覽按鈕(使用這個渲染方式下導出的文件數學公式比較可靠亂碼概率較小)(鼠標移植按鈕上方提示markdown preview ehanced相關或者MPE相關)
如果只有看見一個預覽按鈕,那就是markdown preview ehanced隱藏了vscode自帶的markdown文檔預覽按鈕,所以只顯示了一個markdown preview ehanced的預覽按鈕,直接用就好。
若想恢復vscode自帶的markdown文檔預覽按鈕,則點擊左下角齒輪按鈕進入設置,搜索"Hide Default VSCode Markdown Preview Buttons"取消勾選即可,如下為恢復狀態:
在預覽界面中右鍵,選擇谷歌瀏覽器導出為PDF
總結
以上是生活随笔為你收集整理的MarkDown在VSCode环境下使用的全部內容,希望文章能夠幫你解決所遇到的問題。
- 上一篇: linux用户(user)和用户组(gr
- 下一篇: 机器视觉中的光源选型