1. 爛教程注意:
以下是一個“爛教程”的示例。爛教程的特點就是作者懶得寫清楚,或者干脆不知道應(yīng)該如何寫清楚,不知道把什么寫清楚,不知道寫給誰,當(dāng)然也不知道讀者究竟在哪里需要什么樣的幫助…… 于是寫出來的東西,除了給自己帶來一點存在感之外,對別人實在是用處不大……
有時候,腦子是短路的。寫微信公共賬號都快一年了,也沒想到過應(yīng)該搜搜看看有沒有什么瀏覽器插件可以用來轉(zhuǎn)化 Markdown 格式。要不是在新生大學(xué)的學(xué)習(xí)圈里看到有人提起,那就可能一直想不到。真是沒辦法。
這個插件是 Markdown Here
, 不僅支持 Firefox
、Google Chrome
,也支持 Safari
。
它能把瀏覽器中的文本編輯器里的 Markdown 格式的文本轉(zhuǎn)換成格式化之后的 html,并可以預(yù)先定制 css 樣式。
關(guān)于 Markdown 編輯器,我買過好幾個,各種免費的也比較了好多,最終發(fā)現(xiàn)只要是專門的 Markdown 編輯器就都不夠好用…… 現(xiàn)在我用 Atom 編輯器,加上幾個與 Markdown 相關(guān)的插件:
- markdown-writer
- markdown-toc
- markdown-scroll-sync
- markdown-pdf
- markdown-preview(編輯器內(nèi)建插件)
我測試后的結(jié)果是,微信公共賬號的文字編輯器,其實不解析 h1…h(huán)6 的,它會統(tǒng)一把這些 Heading 搞成 strong
…… 這個比較討厭,所以,只能暫時對付著用,于是,我只好在 Markdown Here 的 Option 里定義了一個 big
,用來替代小標(biāo)題。
.markdown-here-wrapper { font-size: 17px; line-height: 30px;}pre, code { font-size: 14px; font-family: Roboto, 'Courier New', Consolas, Inconsolata, Courier, monospace;}code { margin: 0 3px; padding: 0 6px; white-space: pre-wrap; background-color: #F8F8F8; border-radius: 2px; display: inline;}pre { font-size: 15px; line-height: 20px;}pre code { white-space: pre; overflow: auto; border-radius: 3px; padding: 5px 10px; display: block !important;}strong, b{ color: #BF360C;}em, i { color: #009688;}big { font-size: 22px; color: #009688; font-weight: bold; vertical-align: middle; border-bottom: 1px solid #eee;}small { font-size: 12px; line-height: 22px;}hr { border-bottom: 0.05em dotted #eee; margin: 10px auto;}p { margin: 15px 5px !important;}table, pre, dl, blockquote, q, ul, ol { margin: 10px 5px;}ul, ol { padding-left: 10px;}li { margin: 5px;}li p { margin: 5px 0 !important;}ul ul, ul ol, ol ul, ol ol { margin: 0; padding-left: 10px;}ol ol, ul ol { list-style-type: lower-roman;}ul ul ol, ul ol ol, ol ul ol, ol ol ol { list-style-type: lower-alpha;}dl { padding: 0;}dl dt { font-size: 1em; font-weight: bold; font-style: italic;}dl dd { margin: 0 0 10px; padding: 0 10px;}blockquote, q { border-left: 3px solid #009688; padding: 0 10px; color: #777; quotes: none;}blockquote::before, blockquote::after, q::before, q::after { content: none;}h1, h2, h3, h4, h5, h6 { margin: 20px 0 10px; padding: 0; font-weight: bold; color: #009688;}h1 { font-size: 24px; border-bottom: 1px solid #ddd;}h2 { font-size: 22px; border-bottom: 1px solid #eee;}h3 { font-size: 20px;}h4 { font-size: 18px;}h5 { font-size: 16px;}h6 { font-size: 16px; color: #777;}table { padding: 0; border-collapse: collapse; border-spacing: 0; font-size: 1em; font: inherit; border: 0;}tbody { margin: 0; padding: 0; border: 0;}table tr { border: 0; border-top: 1px solid #CCC; background-color: white; margin: 0; padding: 0;}table tr:nth-child(2n) { background-color: #F8F8F8;}table tr th, table tr td { font-size: 16px; border: 1px solid #CCC; margin: 0; padding: 5px 10px;}table tr th { font-weight: bold; background-color: #F0F0F0;}
因為畢竟提供了一點有用的信息,所以,若是傳播足夠廣,總是會有一些人有收獲,然后禮貌地致謝??蓮牧硗庖粋€角度來看,這種禮貌反過來又會讓爛教程的作者以為自己這樣就可以了…… 許多年之后都不知道應(yīng)該在什么地方后悔。
3. 好教程是什么樣的?好教程的作者,知道自己寫給誰看,知道讀者需要的是什么,知道讀者哪里搞不清楚,知道讀者在哪里會遇到困難,知道讀者讀過之后會有什么樣的反饋…… 這其實很難的 —— 要反復(fù)實驗、反復(fù)實踐才能做好。
關(guān)于如何使用 Atom 編輯器,大家不妨移步看看這個教程:
http://xiaolai.li/2016/06/17/makecs-atom-advanced/