如何使用Markdown在WordPress與OneNote中記筆記

?富文本格式中最成功的一種,我認(rèn)為是HTML.這毫無疑問是當(dāng)今互聯(lián)網(wǎng)上流傳最多的一種文本.(廣義上的HTML,包括了H5,CSS3,JS)但是日常辦公中,我們經(jīng)常接觸的是word文檔,pdf文檔.然而這上面這三種格式,有利于排版或者有利于印刷,不方便進(jìn)行寫作和編輯.(不方便指的是文本編輯器寫不了QAQ)LaTeX可以實(shí)現(xiàn)所想即所得的效果,但是想要實(shí)現(xiàn)預(yù)覽,即所見即所得,編譯鏈的配置也是十分麻煩的.

這里就體現(xiàn)出Markdown這種標(biāo)記語言的優(yōu)勢(shì)了,小巧,簡(jiǎn)單,適合速記,帶基本的格式.雖然Markdown不能代替上面的排版格式,但是其簡(jiǎn)單的語法,內(nèi)聯(lián)HTML的特性,還是很適合記筆記,寫博客,wiki之類的文章.

但是想要打印,發(fā)布到wordpress,同步到OneNote,將Markdown轉(zhuǎn)換為其他格式是必不可少的一道工序.本文將介紹如何利用VScode編輯Markdown,發(fā)布到WordPress,將渲染好的網(wǎng)頁插入到OneNote中.畢竟一本花費(fèi)心血寫出來的筆記,需要一個(gè)合適的內(nèi)容管理系統(tǒng).

使用到的工具

VScode及MarkdownAllinOne,MarkdownPDF插件

OneNoteUWP版本

WordPress5.4及WPEditor.md插件

GoogleChrome瀏覽器

VS code編輯Markdown

VScode的確是一款優(yōu)秀的GUI編輯器(雖然有時(shí)我也會(huì)在VScode的終端里面直接用Vim).o(￣▽￣)o.配合下面的插件可以在VScode里面流暢地編輯Markdown.

此外還有諸如MarkdownPreviewEnhanced,MarkdownPreviewGithubStyling等也非常好用.安裝好MarkdownAllinOne后就可以一邊編輯Markdown一邊實(shí)時(shí)預(yù)覽了.

使用Markdown在WordPress上寫文章

脫離了VScode之后,會(huì)遇到各種障礙.WordPress的編輯器從5.X以后的版本就逐漸不如人意了.使用Markdown,你可以利用VScode生成的HTML配合Markdown和Katex的CSS與JS文件完成寫作;也可以使用插件,但是需要更改一下在VScode中寫好的文本.

博主使用的WordPress插件是WPEditor.md,雖然有Bug但是可以用.正常的Markdown語法可以支持,但是遇到公式,需要做微調(diào).

WPEditor.md支持Katex,其實(shí)在VScode上面使用的插件也是使用的Katex.只是在翻譯成HTML渲染的時(shí)候,WPEditor.md遇到了如下問題:Katex的公式內(nèi)換行使用的是\\,在WPEditor.md中,需要輸入三個(gè)\反斜杠;行內(nèi)公式的希臘字母下標(biāo)需要使用大括號(hào).例如:eρ?,在行內(nèi)編輯時(shí)需要寫為:\vec{e_{\rho}}.

解決方法:

使用VScode將\\替換為\\\

使用VScode將行內(nèi)的希臘字母下標(biāo)的Katex公式}_\rho替換為_{\rho}}

將Markdown文本輸出到OneNote

OneNote已經(jīng)做的很好了,但是整體不如Markdown輕便,獨(dú)立一格的數(shù)據(jù)庫存儲(chǔ)方式讓人摸不著頭腦,即使使用插件也不能支持全部的Markdown語法.使用OneNote也就方便設(shè)備間的協(xié)同與Windows設(shè)備上流暢的手寫體驗(yàn).

OneNote可以插入HTML的富文本,但是在Markdown渲染出的HTML面前,我還沒有找到方法.可以插入word文檔,但是Pandoc不能渲染Katex公式,明明在Typora上面是可以渲染的.于是我只能給出打印輸出的方法,不能在OneNote里面編輯,但是可以查看.畢竟,使用OneNote對(duì)于我來講,還是手寫,也正是因?yàn)槭謱懝�式不如打印的工�?才考慮使用Markdown.

使用VScode將Markdown輸出為HTML

使用VScode插件MarkdownPDF,并做如下配置.參考該篇博文的方法,在文件

C://Users//.vscode/extensions/yzane.markdown-pdf-/template/template.html

的末尾添加MathJax的支持,復(fù)制粘貼進(jìn)去.

微調(diào),MathJax又是一種將Markdown翻譯為HTML的方式,所以也會(huì)出現(xiàn)一些Bug,博主遇到的是_字符,轉(zhuǎn)義為成對(duì)的,導(dǎo)致亂碼;Katex公式內(nèi)換行的反斜杠一個(gè)會(huì)被翻譯成轉(zhuǎn)義字符的前綴,此時(shí)需要四個(gè)反斜杠:\\\\.解決方法:

使用VScode將_替換為_

使用VScode將\\替換為\\\\

HTML打印到OneNote中

在修改好的md文件中右鍵,單擊MarkdownPDF:Export(html).得到HTMl文件.使用Chrome打開該文件,打印到OneNoteforWindows中,在彈出的OneNote中選擇輸出的分區(qū).

效果

在VScode中編輯Markdown

在WordPress中發(fā)布

在Chrome中預(yù)覽HTML

在OneNote中打印輸出