安裝Markdown All in One插件
該插件提供了一些Markdown書寫過程中非常便捷性的一些操作,同時支持了latex公式,能夠讓你的VScode markdown Preview識別你所書寫的公式。
安裝Markdown Math插件
該插件在寫\(latex\)公式時提供代碼提示和代碼補全的功能。
安裝Markdown PDF插件
該插件提供了將markdown文件輸出為可預覽的不同格式文件,包括html,pdf等。
問題及解決方案
遇到問題
安裝markdown pdf插件后,發現對有數學公式的文檔輸出pdf文檔時無法渲染,是按源代碼輸出
解決方案
安裝markdown pdf插件后,可以找到如下路徑文件
C://Users/<username>/.vscode/extensions/yzane.markdown-pdf-1.4.1/template/template.html
然后在該文件末尾添加如下兩行
<script type="text/javascript" src="http://cdn.mathjax.org/mathjax/latest/MathJax.js?config=TeX-AMS-MML_HTMLorMML"></script>
<script type="text/x-mathjax-config"> MathJax.Hub.Config({ tex2jax: {inlineMath: [['$', '$']]}, messageStyle: "none" });</script>
再輸出就正常了!
其它
Markdown PDF 依賴 Chromium,因此默認情況下,它會嘗試下載 Chromium,但是由於某種原因,在國內,默認情況下它是無法下載的,所以您得手動下載它。其實不必非要下載 Chromium,如果您的電腦中已經安裝了 Chrome 瀏覽器或者edge(chromium版),那只需要簡單配置一下路徑即可。
找到相關應用路徑
- 找到 Chrome 應用的路徑,比如,默認是
C:\Program Files (x86)\Google\Chrome\Application\chrome.exe
- 找到 Edge應用的路徑,比如,默認是
C:\Program Files (x86)\Microsoft\Edge\Application\msedge.exe
配置VSCode
打開 VS Code 設置,建議在用戶設置下面添加"markdown-pdf.executablePath": "C:\\Program Files (x86)\\Google\\Chrome\\Application\\chrome.exe"
這一項,注意路徑中是兩個反斜杠,如果是Edge則用相應的路徑替代。
后記
在后續使用中,發現markdown輸出pdf的效果不理想,比如字體、腳注、latex代碼支持不全面等問題,於是對比使用了markdown preview enhanced,其配置也簡單,添加chrome或者edge應用路徑即可,輸出pdf的效果也很理想。