重新認(rèn)識Markdown

最近在調(diào)研文檔寫作工具饶米,對 Markdown 有了一些新的思考。

Markdown 的優(yōu)勢

毫無疑問髓抑,Markdown 是流行的咙崎,個人認(rèn)為有以下幾個原因:

  1. 容易上手,設(shè)計得對新手非常友好吨拍,把最常用的十幾個樣式抽離出來褪猛,可以滿足日常90%的編寫場景
  2. 社區(qū)支持,如Github羹饰,Hexo等伊滋,國內(nèi)的博客平臺CSDN,簡書等也都支持了
  3. 工具鏈完善队秩,VS Code笑旺,Sublime等幾乎所有的編輯器都支持Markdown擴(kuò)展,在線網(wǎng)站馍资,筆記工具筒主,GitBook等等,可選擇的編寫工具非常多

Markdown 的劣勢

  1. 復(fù)雜格式(例如表格、圖片標(biāo)題)支持不夠乌妙。
  2. 沒有預(yù)留擴(kuò)展語法使兔,導(dǎo)致不同網(wǎng)站、工具各自擴(kuò)展產(chǎn)生了很多方言(參考Lisp)藤韵。
  3. 沒有統(tǒng)一標(biāo)準(zhǔn)

社區(qū)有不少人意識到問題虐沥,其中就有 Jeff Atwood 牽頭,聯(lián)合 Stack Overflow泽艘、Github欲险、Reddit 的一些員工發(fā)起了 Standard Markdown 項目,希望將 Markdown 標(biāo)準(zhǔn)化匹涮。 沒想到項目起步遇到的最大阻力是 Markdown 的創(chuàng)建者 John Gruber天试,John 很不滿意 Jeff 在未充分溝通的情況下宣稱自己的項目是“Standard”,經(jīng)過一番爭吵焕盟,Jeff 把項目改名為 Common Markdown 秋秤,John 也沒有加入項目。這個 Common Markdown 至今也沒有被廣發(fā)采納脚翘。
另外灼卢,我覺 GitBook 多少沾了 Git 的光,DocBook 肯定更勝一籌来农。

使用誤區(qū)

在使用 Hexo 寫博客的過程中鞋真,我養(yǎng)成了一個不太好的習(xí)慣,就是癡迷于擴(kuò)展沃于,Hexo本身通過擴(kuò)展豐富了 Markdown 的功能涩咖,但當(dāng)我想要在簡書、知乎發(fā)布同一文章時繁莹,可移植性就成了阻礙檩互。
另外,嵌入 Html 解決復(fù)雜格式問題同樣不是明智的選擇咨演,這相當(dāng)于把樣式帶入了內(nèi)容闸昨。

重新認(rèn)識 Markdown

首先,不要過度依賴 Markdown薄风,通過擴(kuò)展饵较,Markdown確實能支持很多功能,但這些東西更像是平臺的特有功能遭赂,而不是 Markdown 本身循诉。其次,認(rèn)識 Markdown 的使用場景撇他,大部分文章的排版都不會很復(fù)雜茄猫,Markdown基本能hold住狈蚤,再復(fù)雜就應(yīng)該用 Sphinx 或者 Asciidoc之類的工具,如果還不能滿足募疮,再用 LaTeX炫惩,雖然宰牛刀殺雞有點浪費(fèi),但殺雞的刀是一定宰不了牛阿浓,本質(zhì)還是權(quán)衡學(xué)習(xí)成本和自身需求。

參考

?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請聯(lián)系作者
  • 序言:七十年代末蹋绽,一起剝皮案震驚了整個濱河市芭毙,隨后出現(xiàn)的幾起案子,更是在濱河造成了極大的恐慌卸耘,老刑警劉巖退敦,帶你破解...
    沈念sama閱讀 218,858評論 6 508
  • 序言:濱河連續(xù)發(fā)生了三起死亡事件,死亡現(xiàn)場離奇詭異蚣抗,居然都是意外死亡侈百,警方通過查閱死者的電腦和手機(jī),發(fā)現(xiàn)死者居然都...
    沈念sama閱讀 93,372評論 3 395
  • 文/潘曉璐 我一進(jìn)店門翰铡,熙熙樓的掌柜王于貴愁眉苦臉地迎上來钝域,“玉大人,你說我怎么就攤上這事锭魔±ぃ” “怎么了?”我有些...
    開封第一講書人閱讀 165,282評論 0 356
  • 文/不壞的土叔 我叫張陵迷捧,是天一觀的道長织咧。 經(jīng)常有香客問我,道長漠秋,這世上最難降的妖魔是什么笙蒙? 我笑而不...
    開封第一講書人閱讀 58,842評論 1 295
  • 正文 為了忘掉前任,我火速辦了婚禮庆锦,結(jié)果婚禮上捅位,老公的妹妹穿的比我還像新娘。我一直安慰自己肥荔,他們只是感情好绿渣,可當(dāng)我...
    茶點故事閱讀 67,857評論 6 392
  • 文/花漫 我一把揭開白布。 她就那樣靜靜地躺著燕耿,像睡著了一般中符。 火紅的嫁衣襯著肌膚如雪。 梳的紋絲不亂的頭發(fā)上誉帅,一...
    開封第一講書人閱讀 51,679評論 1 305
  • 那天淀散,我揣著相機(jī)與錄音右莱,去河邊找鬼。 笑死档插,一個胖子當(dāng)著我的面吹牛慢蜓,可吹牛的內(nèi)容都是我干的。 我是一名探鬼主播郭膛,決...
    沈念sama閱讀 40,406評論 3 418
  • 文/蒼蘭香墨 我猛地睜開眼晨抡,長吁一口氣:“原來是場噩夢啊……” “哼!你這毒婦竟也來了则剃?” 一聲冷哼從身側(cè)響起耘柱,我...
    開封第一講書人閱讀 39,311評論 0 276
  • 序言:老撾萬榮一對情侶失蹤,失蹤者是張志新(化名)和其女友劉穎棍现,沒想到半個月后调煎,有當(dāng)?shù)厝嗽跇淞掷锇l(fā)現(xiàn)了一具尸體,經(jīng)...
    沈念sama閱讀 45,767評論 1 315
  • 正文 獨居荒郊野嶺守林人離奇死亡己肮,尸身上長有42處帶血的膿包…… 初始之章·張勛 以下內(nèi)容為張勛視角 年9月15日...
    茶點故事閱讀 37,945評論 3 336
  • 正文 我和宋清朗相戀三年士袄,在試婚紗的時候發(fā)現(xiàn)自己被綠了。 大學(xué)時的朋友給我發(fā)了我未婚夫和他白月光在一起吃飯的照片谎僻。...
    茶點故事閱讀 40,090評論 1 350
  • 序言:一個原本活蹦亂跳的男人離奇死亡娄柳,死狀恐怖,靈堂內(nèi)的尸體忽然破棺而出戈稿,到底是詐尸還是另有隱情西土,我是刑警寧澤,帶...
    沈念sama閱讀 35,785評論 5 346
  • 正文 年R本政府宣布鞍盗,位于F島的核電站需了,受9級特大地震影響,放射性物質(zhì)發(fā)生泄漏般甲。R本人自食惡果不足惜肋乍,卻給世界環(huán)境...
    茶點故事閱讀 41,420評論 3 331
  • 文/蒙蒙 一、第九天 我趴在偏房一處隱蔽的房頂上張望敷存。 院中可真熱鬧墓造,春花似錦、人聲如沸锚烦。這莊子的主人今日做“春日...
    開封第一講書人閱讀 31,988評論 0 22
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽涮俄。三九已至蛉拙,卻和暖如春,著一層夾襖步出監(jiān)牢的瞬間彻亲,已是汗流浹背孕锄。 一陣腳步聲響...
    開封第一講書人閱讀 33,101評論 1 271
  • 我被黑心中介騙來泰國打工吮廉, 沒想到剛下飛機(jī)就差點兒被人妖公主榨干…… 1. 我叫王不留,地道東北人畸肆。 一個月前我還...
    沈念sama閱讀 48,298評論 3 372
  • 正文 我出身青樓宦芦,卻偏偏與公主長得像,于是被迫代替她去往敵國和親轴脐。 傳聞我的和親對象是個殘疾皇子调卑,可洞房花燭夜當(dāng)晚...
    茶點故事閱讀 45,033評論 2 355

推薦閱讀更多精彩內(nèi)容

  • 最近遇到一些問題,就是團(tuán)隊中會有些伙伴踩得坑的收集問題或者有些較為復(fù)雜的業(yè)務(wù)需求文檔共享上成本較高大咱,所以考慮弄...
    tobAlier閱讀 3,898評論 0 5
  • 本文詳細(xì)講解了 Gitbook 生成電子書的完整過程令野,內(nèi)容包括:安裝、命令徽级、配置、文檔結(jié)構(gòu)聊浅、生成電子書餐抢、部署。限于...
    靜默虛空閱讀 11,257評論 9 138
  • 關(guān)于Markdown 一整個學(xué)期下來低匙,我覺得讓我收獲最大之一的是學(xué)會markdown語言旷痕。我們平常都是使用Word...
    Dacade閱讀 942評論 0 2
  • 最近發(fā)現(xiàn)了了一個不錯的AndroidStudio主題,整體配色淡雅又不失炫酷活潑顽冶,包括GUI和Schema以及l(fā)o...
    木水Code閱讀 205評論 0 1
  • 愛欺抗,我們總認(rèn)為是一個名詞,是一種狀態(tài)强重,而其實绞呈,它是一個動詞,是一種行為间景! 1. 我們從來都不缺愛佃声,只是缺少感受...
    陶_c253閱讀 275評論 0 0