Skip to content

Instantly share code, notes, and snippets.

Show Gist options
  • Star 10 You must be signed in to star a gist
  • Fork 2 You must be signed in to fork a gist
  • Save illy/2963861 to your computer and use it in GitHub Desktop.
Save illy/2963861 to your computer and use it in GitHub Desktop.
豆瓣預覽

前陣子一直打算謝謝markdown寫作,拖到現在被這位老兄搶了先,很不錯的介紹文章:[为什么Markdown+R有较大概率成为科技写作主流?](http://www.douban.com/note/220903450/).所以我就不再重複了,此文打算用問答的形式介紹下markdown對於文科寫作的意義[^ft]。

###1. 什麼是markdown?

markdown是一種輕量化的標記語言。大家所熟知的標記語言還有latex,lyx, XML,HTML,這類文本的特點就是你在編輯時可以使用各種tag來控制文本的格式。話說回來,mac下的pages,M$的docx也都時XML文檔,只是你在編輯的時候,不需要加入tag,軟件本身替你增加tag了。

這類語言最大的好處就是在編輯時,你可以很大程度的減少格式對於文本的干擾。你想啊,打開一個word文檔,你調個文字大小,設置個 加粗,二號標題,再來個 斜體 什麼的, 時間大半過去了。而標記語言的最大優勢在於,你只要使用系統能夠識別的tag就可以非常方便地控制這些格式。比如markdown,你可以先使用系統默認的那些tag來寫作,等到最後輸出的時候,配置下css模版即可。

markdown是各種標記語言中的小兄弟,一來是因為它年輕,二來因為它非常輕量化。md是 John GruberAaron Swartz 最初發明的,廣泛用於技術文檔的寫作。它的最大優勢在於人機皆可讀 (machine-readble, human-readble)。

###2. 為什麼文科生應該使用markdown寫作?

md大量使用在技術寫作中,比如各種軟件的readme,本來大家都習慣用txt,現在越來越多的readme都使用md,做得非常漂亮。可是為什麼文科生也該使用md呢?

文科的寫作很少有公式 (當然現在不排除各種交叉學科大量使用公式),似乎沒有很大必要使用什麼標記語言。其實不然,正因為文科寫作很少有公式,用md出來起來更加容易。陽志平老兄的那篇文章提到了md寫作的極大優勢:減少干擾優化排版版本跟蹤協同寫作。總結得很不錯。

對於文科寫作,最大的優勢就是減少干擾了。 記得之前參加過學校的一個博士論文寫作workshop,很多文科博士生都提到自己花在排版上的時間太多了,很多時候打開word想寫東西,結果一個加粗,一個三號標題,弄來弄去時間就沒了... 而使用md,這一切你都不用管,只要在寫作是簡單地加入一些tag即可,等到寫完,再去配置css模版。

###3. 老闆不認可怎麼辦?

我沒遇到這個問題。我老闆自己用latex寫的博士論文,寫完就不用了;後來他開始做jouranl的時候,是一個online journal,採用PhP markdown,要求作者在提交時就使用這個格式,而不是什麼doxc。所以,我當初提到要用md寫我的畢業論文時,我老闆還是蠻支持的。

###4. 老闆不喜歡讀md怎麼辦? 雖然md是輕量化的標記語言,tag使用得不多,人機皆可讀, 但還是有人擔心直接提交md時,對方沒有可以閱讀md的工具怎麼辦(這樣打開的時候,就會和你編輯時一樣,就像你現在讀到的)。

做法很簡單,你可以輸出為pdf或着html。大多數md編輯器都支持兩種輸出。

###5. 談談你和你老闆怎麼做的吧?

一開始我就用googld docs把草稿提交給我老闆。他也比較喜歡這種方式,一來批閱起來方便,二來,我們都可以看到版本歷史,再來,都是無紙化操作,我們兩個都方便。

使用md後,我試過兩種方式,一是直接把md原文複製粘貼到google docs上分享給他;二十輸出喂pdf給他。他看了看後,還是讓我原文輸出,這樣他批閱起來比較方便。

原文輸出的唯一問題在於,你的md文本會看起來有些亂,尤其時用tab縮進的。好在我老闆不在意,他說,等你最後定稿時,反正時pdf,誰都不知道你是用md寫的,所以沒關係啦。

總之,和你老闆溝通下,看看他認不認可md,或者多和他推薦推薦。

###6. 你用什麼寫markdown?

其實任何文本編輯器都可以寫md,只要你在保存時,把文件先保存為txt,然後把後綴改為md即可。

我之前使用mou.app, 由Chen Luo 開發。mac平台, beta版免費,正式版可能收費。目前已經開發到0.7.1,解決了不少bug。這玩意支持即時預覽,即你在左邊的文本框內輸入的時候,右邊的預覽框即時顯示md的效果。用起來挺舒服的,目前我越到的唯一問題時,這玩意處理長文本時非常慢,比如你的文本長達四五千詞時,這玩意會變得非常非常慢。

通過教育優惠,我購買了scrivene,這玩意又mac和win兩個版本,支持multi-markdown(mmd),適合大文本寫作。也就是這玩意時專門用來寫博士論文,長篇小說,或者電影劇本的。

後來,我直接在vim下安裝了md的相關插件,這樣在vim下也可以方便地使用md寫作。這些插件可以在github上找到。當然vim不太容易上手,而且這些插件都有些小bug,比如處理長文本是,格式會識別錯誤。

因為最近的WWDC12和Tuesdayapp,我乘減價時購買了Byword.appmarked.app。前者是一款OS X/iOS版本的寫作軟件,支持所見即所得,即你輸入什麼格式,顯示什麼格式,和word類似。後者是一款mmd預覽軟件,支持md和mmd。另外marked的開發者Brett Terpstra是一個很活躍的md支持者,開發了眾多的md工具,在他的個人網站下可以找到免費的nvALT和眾多md/mmd輸出轉換工具。

###7. 表格怎麼辦? 的確,md/mmd對於表格還不是很支持。你可以按照md語法用+和-來製表。

我比較偷懶,直接縮進後,用tab來對齊,也就是做成一個無框表格。

估計今後md語法會有所改變,對於表格更加友善吧?

###8. 腳註怎麼辦? 論文寫作中經常會使用腳註,可惜md本身不支持。

好消息是mmd支持腳註,只要在文本中使用[^ft]標示出腳註的位置,然後另起一行:

[^ft] 2. 這是一個腳註

###9. referneces怎麼辦? APA格式中,reference需要懸垂縮進(hanging indent),可是md本身不支持這種格式。

沒關係,由牛人開發了相應的css模版,在github可以找到,只要在md文檔中添加相應的代碼即可。


關於文科寫作使用md大概是這些問題,又問題的可以在下面留言,我盡量回答吧。

[^ft]1. 此文用multi-markdown寫作,markdown的進化版

@risshun
Copy link

risshun commented Feb 12, 2015

scrivener,你少输入了一个“r”

@ASC8384
Copy link

ASC8384 commented Feb 8, 2018

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment