只需一行代碼,你的純文本秒變Markdown
只要你有純文本編輯器,加上一條語(yǔ)句,瞬間它就可以成為 Markdown 編輯器。
Markdeep 是一個(gè)用來(lái)寫純文本的插件,它能以 Markdown 的語(yǔ)法與渲染方式純文本,并在網(wǎng)頁(yè)上展示。同時(shí),除了 Markdown 語(yǔ)法,Markdeep 還額外支持圖表、數(shù)學(xué)方程等擴(kuò)展能力。
項(xiàng)目主頁(yè):https://casual-effects.com/markdeep/
我們先看看效果,如下左邊是純文本編輯器的編輯頁(yè)面,右邊是在瀏覽器上的渲染效果:
Markdeep 非常容易使用,它也不需要安裝插件或聯(lián)網(wǎng)。如上所示只要在純文本最后加上「<!—Markdeep→」那一行的表達(dá)式,它就可以變成一個(gè)地道的 Markdown 編輯器。Markdeep 不需要額外安裝任何東西,也不需要導(dǎo)出、編譯等雜七雜八的過(guò)程。
看著 Markdeep 很簡(jiǎn)單,但它的功能卻不少,一點(diǎn)也不遜色于 Typora 等正統(tǒng)的 Markdown 編輯器。不論我們是寫項(xiàng)目的 README 文檔、實(shí)驗(yàn)報(bào)告,還是要做 PPT 或?qū)懻撐模寄軡M足。該項(xiàng)目提供了很多示例,例如生成的 PPT 是什么樣的,后文會(huì)具體展示。
開源代碼
Markdeep 是開源的,所以可以直接下載和修改源代碼文件 markdeep.js。整個(gè)編輯器就是一個(gè) JavaScript 腳本,上面定義了各種格式與渲染方式。作者表示,目前他正研究該如何有效降低腳本文件大小。
用于表格處理的部分代碼,整個(gè)腳本有超過(guò) 5000 行代碼。
腳本源碼地址:https://casual-effects.com/markdeep/latest/markdeep.js
作者表示,這個(gè)項(xiàng)目本來(lái)就是一個(gè)業(yè)余項(xiàng)目,它并不會(huì)有完整的技術(shù)支持。不過(guò)只要提交的 Bug 足夠具體,作者都會(huì)完善它。此外,該項(xiàng)目還會(huì)經(jīng)常加入一些新特性,從 2015 年 10 月份的第一版,到今年 2 月份的最新版,這個(gè)編輯器已經(jīng)維護(hù)了很長(zhǎng)時(shí)間。
Markdeep 怎么用
如果你需要?jiǎng)?chuàng)建一個(gè) Markdeep 的文件,只需要打開任意一個(gè)文本編輯器,然后開始編輯。完成文本編輯工作后,只需要在其底部寫下一個(gè)簡(jiǎn)單的代碼就行了。然后,將這個(gè)文檔保存為純文本文件,使用 .md.html 為擴(kuò)展名。
- <!-- Markdeep: --><style class="fallback">body{visibility:hidden;white-space:pre;font-family:monospace}</style><script src="markdeep.min.js" charset="utf-8"></script><script src="https://casual-effects.com/markdeep/latest/markdeep.min.js" charset="utf-8"></script><script>window.alreadyProcessedMarkdeep||(document.body.style.visibility="visible")</script>
如果你希望在源文檔中使用 Unicode,則需要在文檔頂部先加上這句話:
- <meta charset="utf-8">
想要看看效果?你可以將文本拖入瀏覽器或雙擊它。即使網(wǎng)絡(luò)離線也可以查閱文檔。如果不想因?yàn)殡x線而失去格式,可以將 markdeep.min.js 文件和文檔保存在一個(gè)文件夾中。
如果想要看看 Markdeep 原始文本,在文件 URL 最后加上「?noformat」即可。
上手示例
小編隨手測(cè)試了幾個(gè)典型 Markdown 語(yǔ)法,比如:代辦列表、自動(dòng)鏈接、表格、內(nèi)聯(lián)圖片、代碼。與此同時(shí),LaTeX 的數(shù)學(xué)表達(dá)式和圖形也能直接設(shè)計(jì),而不需要任何插件。具體效果可參考:
簡(jiǎn)而言之,配備完善,對(duì)于熟悉 Markdown 的小伙伴來(lái)說(shuō),用起來(lái)會(huì)十分順手及方便。這意味著,在有網(wǎng)的情況下,隨意拎一個(gè)文本編輯器后,就再也沒(méi)有人能攔得了你使用 Markdown 了。與此同時(shí),時(shí)時(shí)預(yù)覽效果也非常簡(jiǎn)便,只需要在文本編輯器里修改,瀏覽器中刷新下便可呈現(xiàn)最新效果。
Markdeep 能干什么
只要是 Markdown 支持的,Markdeep 就能夠支持,它在業(yè)界和學(xué)術(shù)界能得到廣泛使用。如下所示,各種題材與格式的文檔都能用 Markdeep 完成:
- API 文檔
- 教學(xué)大綱
- 游戲設(shè)計(jì)文件
- 家庭作業(yè)
- 課程 PPT
- 軟件庫(kù)網(wǎng)站
- 個(gè)人博客
- 簡(jiǎn)歷
- 論文
看起來(lái) Markdeep 似乎什么都能做,項(xiàng)目作者同樣也展示了這些方面的效果圖:
Markdeep 制作的 PPT。
Markdeep 制作的個(gè)人簡(jiǎn)歷。
總之,除了使用方便、展示炫酷,Markdeep 的功能也是非常強(qiáng)大。正如其它開發(fā)者所強(qiáng)調(diào)的,Markdeep 是能制作簡(jiǎn)單圖表的 Markdown 工具,它以一種「ASCII Art」的方式用純文本制作出圖形,并且不用渲染也非常明晰。