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

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

這里就體現出Markdown這種標記語言的優勢了,小巧,簡單,適合速記,帶基本的格式.雖然Markdown不能代替上面的排版格式,但是其簡單的語法,內聯HTML的特性,還是很適合記筆記,寫博客,wiki之類的文章.

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

使用到的工具

VScode及MarkdownAllinOne,MarkdownPDF插件

OneNoteUWP版本

WordPress5.4及WPEditor.md插件

GoogleChrome瀏覽器

VS code編輯Markdown

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

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

使用Markdown在WordPress上寫文章

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

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

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

解決方法:

使用VScode將替換為

使用VScode將行內的希臘字母下標的Katex公式}_rho替換為_{rho}}

將Markdown文本輸出到OneNote

OneNote已經做的很好了,但是整體不如Markdown輕便,獨立一格的數據庫存儲方式讓人摸不著頭腦,即使使用插件也不能支持全部的Markdown語法.使用OneNote也就方便設備間的協同與Windows設備上流暢的手寫體驗.

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

使用VScode將Markdown輸出為HTML

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

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

的末尾添加MathJax的支持,復制粘貼進去.

微調,MathJax又是一種將Markdown翻譯為HTML的方式,所以也會出現一些Bug,博主遇到的是_字符,轉義為成對的,導致亂碼;Katex公式內換行的反斜杠一個會被翻譯成轉義字符的前綴,此時需要四個反斜杠:\.解決方法:

使用VScode將_替換為_

使用VScode將替換為\

HTML打印到OneNote中

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

效果

在VScode中編輯Markdown

在WordPress中發布

在Chrome中預覽HTML

在OneNote中打印輸出