Markdown-VScode打造Markdown编辑器
VScode 打造 Markdown 編輯器
在之前的博文中我分別介紹了 Markdown 的基礎語法和數學公式語法,本文主要介紹使用現在非常流行的 Vscode 代碼編輯器進行 Markdown 書寫的一些配置。
插件
這里主要推薦三款核心插件,其余的可以按需選擇。
- Markdown All in One 目前 Vscode 最流行的 Markdown 語法解析器。
- Markdown PDF 使用的 Markdown 文件渲染導出插件。
- Markdown TOC 一款針對 Github 等平臺自動生成文章目錄的插件(目前主流的博客平臺如 CSDN 已經不需要自己在文中生成目錄了)。
安裝方式也很簡單,在 Vscode 的左側導航欄最后一個聯網搜索 markdown 關鍵字,找到對應插件點擊安裝(下圖 install)即可,上述幾個插件都是高排名插件,最前面就能找到。步驟如下圖。
Markdown All in One
就像插件的名字一樣,將之前很多其他編輯器需要多插件配合的 Markdown 環境整合為一個,支持多種 Markdown 語法、實時預覽、快捷鍵解析等功能。
安裝之后打開以.md或者.markdown為后綴結尾的 Markdown 文件,就可以右側窗口實時預覽渲染效果,當然,也可以使用Ctrl+B這樣的快捷鍵直接進行一些 Markdown 語法操作,這里就是自動補**content**語法標記。
具體的語法可以參考本文引言中的鏈接,安裝后編輯器界面如下。
Markdown PDF
該插件可以實用地將 MArkdown 文件渲染的顯示結果(基于 HTML)導出為 HTML、PDF、PDG、JPEG 等格式的文件,而不需要用戶自己處理繁瑣的圖片路徑等問題。
安裝后在 Markdown 文件的編輯界面中右擊即可顯示菜單欄,在其中的如下幾項就是該插件提供的,點擊即可導出,這表示當前 Markdown 文件目錄下生成對應 PDF,文件名相同,其他需要的可以自行對插件進行配置。
對當前教程導出后,某一頁結果如下。
Markdown TOC
在一些平臺如 Github 渲染 Markdown 文件是不能自動目錄的,需要自己手寫,而繁瑣的 HTML 語法又不太方便,使用該插件即可快速生成自動目錄。
使用方法很簡單,在需要添加目錄的地方右擊菜單欄,可以看到如下幾個 TOC 插件功能,前面兩個是章節自動編號(用的不多),后面兩個則是自動增加或者更新目錄和刪除目錄。
該插件使用可能會有問題,其中比較常見的是目錄格式異常,這是因為**該插件解析行尾是使用\n而 Vscode 的默認行尾標志是auto所以會生成異常如下。
這里解決方法很簡單,通過修改 VScode 編輯器的默認行尾符號即可。編輯器左下角點擊設置—進入 setting 配置—搜索 eol—修改文件行尾符號為\n即可。
這是,生成的目錄格式正確且渲染正常,如下圖。
這里還需要進行一些配置,主要針對一個需求:我并不需要對一級標題列入目錄中,且想要手動進行目錄編輯,但手動修改目錄后插件會自動更新該區域。
這是因為插件默認配置目錄是自動更新的,這里只需要對插件進行配置即可,具體操作如下:找到安裝的插件—點擊擴展配置—對打開的配置文件最后兩個帶auto的自動選項取消勾選。
此時就可以修改為自己需要的目錄格式了,如下圖。
補充說明
本文主要介紹如何使用 Vscode 進行 Markdown 編輯器的配置, 由于本文發于 CSDN 就沒有添加文章目錄,歡迎點贊收藏本文。
總結
以上是生活随笔為你收集整理的Markdown-VScode打造Markdown编辑器的全部內容,希望文章能夠幫你解決所遇到的問題。
- 上一篇: NVIDIA AGX Xavier环境配
- 下一篇: Transformer论文解读