怎樣引導新手使用 Markdown?

第一次遇到論壇上居然用了 Markdown 結果貼代碼貼錯, 功能出錯的..
其中一條回復多了 & 標籤又沒被解析.. http://cnodejs.org/topic/50229e5ff767cc9a51f2b3ab
怎樣才能更好地引導 Markdown 新的使用者呢?


markdown是為哪些使用者設計的
首先要確定你是否真的需要markdown,使用某種工具是為了提高效率或者某種體驗的,如果這種工具並不能顯著幫你改善體驗,那就讓它見鬼去吧,哪怕這個工具學起來很簡單。
markdown是為那些需要經常碼字或者進行文字排版的、對碼字手速和排版順暢度有要求的人群設計的,他們希望用鍵盤把文字內容啪啪啪地打出來後就已經排版好了,最好從頭到尾都不要使用滑鼠。這些人包括經常需要寫文檔的碼農、博客寫手、網站小編、出版業人士等等。
通常情況下,網路上需要進行大量文字輸入的地方都可以通過所見即所得的方式排版(比如知乎的答案編輯模式),本地寫作的話則可以使用word這類常用的文本編輯軟體,當然你也可以蛋疼地手工使用html標籤實現排版效果——而markdown只是使這一切更方便了一點而已,所以如果你覺得現有文本編輯方式完全夠用了,就別費神折騰了(除非你在使用像github這樣markdown作為主流編輯方式的網站)。

markdown語法

ok,如果你決定使用markdown了,那就先快速學習一下它的語法吧。markdown語法很少很簡單,可以參照下面兩個鏈接中的簡明版,然後在這個在線的markdown-html在線轉換上(Daring Fireball: Markdown Web Dingus)操練操練,不用一個小時就可以掌握。

  • 簡明版 Markdown 語法說明(簡體中文版)
  • 完整版 Markdown 語法說明(簡體中文版)


markdown使用環境

你已經學會使用markdown了,以後就可以開始用markdown寫作了。理論上任意一款文本編輯器都可以寫markdown(寫完之後再轉換成你需要的格式就可以),但有些專門為markdown設計的編輯器,擁有寫作過程中所見即所得的功能(如圖,左邊是純markdown寫作,右邊是它的呈現效果),並且可以方便地將markdown轉化為html。

  • Windows: MarkdownPad
  • Linux: ReText
  • Mac:Mou
  • WordPress:WordPress ? Markdown for WordPress and bbPress ? WordPress Plugins

好了,markdown實在沒有其他什麼東西了,已經可以拿它來寫作你想要寫的東西了。


給個學習思路。

0. 安裝一個好的 Markdown(以下簡稱 MD)文本編輯器,請參考@林青山 的答案

1. 一開始,先記住 `# 這是標題`、`## 這是二級標題`、`### 這是三級標題`
這時候你寫一般小文章會開始感覺 MD 不錯。

2. 然後,你發現標題不適合做列表,記住了用`1. 第一點`、`- 這一點`來列表超級方便。

3. 好吧,寫知乎答案總要有些重點吧,`**加粗**`、`*斜體*`、`~~刪除線~~`開始派上用場了。
這時你基本不會打開 Word 那樣的笨重軟體了。

4. 如果你不幸是碼農:
``這是單行代碼``


//這是代碼段,四個空格或一個製表符縮進
int i;

&> 這是引用

5. 你越來越喜歡,自然會去查查維基(Markdown)還有什麼語法,加上多用,很快就基本掌握了。
MD 還有表格、錨、註腳、貼圖等。強烈推薦 Mou,按 ?+R 可以快速查看語法。

6. 慢慢,你會發現,總有小「bugs」,如列表內無法內嵌代碼段。上網查查,你開始理解 MD 的縮進內嵌機制等高級隱形內容,這樣你就 Master 了!

7. 關鍵一步,催知乎支持 MD 編輯器~用滑鼠排版好累的……
- - -
以下是 Mou 下面的效果,多漂亮:


(一)認識Markdown

簡單的說,Markdown用簡潔的語法代替排版,而不像一般我們用的字處理軟體Word或Pages 有大量的排版、字體設置。

一句話總結,它實際上是個非常簡單、非常容易學習的排版語法。

(二)應該用什麼工具?

Windows平台:

MarkPad,下載地址:MarkPad

Mac平台:

推薦使用Mou(25.io | Mou - Markdown editor for developers, on Mac OS X.)。

iOS 端:

現在已有相當多的App支持Markdown語法編輯,例如Drafts、Day One等,不過很遺憾,這 些App目前都是收費的。

Web平台:

Web端上,推薦簡書(首頁 - 簡書)這款產品,上面有無數熱愛文字的人在不停的創造、分享。

同樣,它支持左右兩欄的實時預覽,字體優雅、簡潔。

馬克飛象:

這裡Mr馮著重推薦馬克飛象,一款簡潔高效的編輯器,提供桌面客戶端以及離線Chrome App,同時支持移動端Web。

馬克飛象是專為印象筆記(Evernote)打造的Markdown編輯器,使用搜索引擎可直接搜索 到,進行在線或下載桌面客戶端離線使用。

在語法規則的介紹中,所需圖片均來自於馬克飛象桌面客戶端。

(三)Markdown語法的簡要規則

標題:

在Markdown中,若一段文字被定義為標題,只要在這段文字前加 # 號即可。

注意:需要在 # 後加一個空格,這是最標準的Markdown語法。

引用:

如果你需要引用一小段別處的句子,那麼就要用引用的格式。

只需要在文本前加入 &> 這種尖括弧(大於號)即可。

圖片與鏈接:

插入鏈接與插入圖片的語法很像,區別在於一個 ! 號。

插入圖片的地址需要圖床,這裡推薦SM.MS(SM.MS)的服務,生成URL地址即可。

粗體與斜體:

Markdown的粗體和斜體也非常簡單,用兩個 * 包含一段文本就是粗體的語法,用一個 * 包含 一段文本就是斜體的語法。

表格:

表格的語法稍微複雜一些,如圖所示:

代碼框:

如果你是個程序猿,需要在文章里優雅的引用代碼框,只需要用兩個 ` 把中間的代碼包裹起 來,使用Tab鍵即可縮進。

分割線:

分割線的語法只需要另起一行,連續輸入三個星號 *** 即可。

(四)小結

如果你看到了這裡,恭喜你,你已經掌握了Markdown 的基本語法。

只要多加練習,配合好用的工具,寫起東西來一定會行雲流水,獲得更好的寫作體驗。


完整版請看這裡:

極簡MarkDown教程(How To)

http://www.cnblogs.com/math/p/se-tools-001.html

## 基本教程

1. 選擇一個在線編輯和預覽站點:比如StackEdit – Editor

2. 選擇一個簡單教程,學會章節、有序條目、無序條目,比如這個下面左邊是MarkDown,右邊是預覽。

好了,你學會MarkDown了,加上條目如果前面四個空格代表縮進,你就可以做結構化排版了,表格和圖片啥的先不管,我用了1年多才去學表格和圖片怎麼用MarkDown排版。

## 表格

關於表格:最方便的表格編輯器其實就是Microsoft Office Excel,於是最近用表格多了,就寫了個Excel轉MarkDown的工具:

不要雙擊,不是GUI軟體,是命令行程序,需要在命令行下使用。例如,你的excel文件在D: est est.xlsx,那麼

1. 在exceltk.exe所在的文件夾左上角菜單:【文件】-&>【打開命令行】,

2. 輸入exceltk.exe -t md -xls d: est est.xlsx 回車

3. 即可在D: est目錄下看到轉換後的md文件。

## 0.1.3 for mac/windows

  • mac: https://github.com/fanfeilong/exceltk/blob/master/pub/exceltk.0.1.3.pkg
  • windows: https://files.cnblogs.com/files/math/exceltk.0.1.3.zip

更新:

  • Mac OS 版本請在命令行下直接使用`exceltk`,不用帶exe後綴,MacOS的安裝包自動配置好環境變數。
  • 去掉GUI剪切版支持,增加MacOS版(安裝後在命令行里就可以用)
  • 支持指定對齊方式
    • exceltk -t md -a r -xls example.xlsx

## 0.0.9 for windows

  • http://fanfeilong.github.io/exceltk0.0.9.7z
  • http://files.cnblogs.com/files/math/exceltk0.0.9.7z

exceltk用例,轉換文件模式

  • 整個表格
    • exceltk.exe -t md -xls xxx.xls
    • exceltk.exe -t md -xls xxx.xlsx
  • 指定sheet
    • exceltk.exe -t md -xls xx.xls -sheet sheetname
    • exceltk.exe -t md -xls xx.xlsx -sheet sheetname
  • 指定小數數字的精度,例如指定精確到小數點後2位數字
    • exceltk.exe -t md -p 2 -xls xxx.xls
  • 使用首行代替表頭,小屏幕頁面顯示的時候,可以簡單自適應
    • exceltk.exe -t md -bhead -xls xxx.xls

exceltk用例,監聽剪貼板模式(0.0.9版本支持,後續版本不再支持)

使用下面方式啟動後,直接從excel里拷貝表格,再粘貼就是markdown格式的表格,界面上也會顯示轉換後的markdown內容。

exceltk.exe -t cm

工具欄上的th選項,用來指定是否把首行當作表頭:

不勾選的時候,沒有表頭:

勾選之後,首行被解釋成表頭:


年初剛剛學習Markdown,前一陣子也在果說的公眾號上總結了一下作為非技術達人的新手,學習Markdown的原因和初學的一點體會,也許可以作為引導其他朋友學習的參考。為了向沒用過的各位新手展示Markdown語法的簡單便捷,我就把用Markdown寫的原文貼在這裡,文中會出現一些星號、井號之類的符號,基本可以包括大部分常用的語法規則了。一般寫成這樣,貼在Markdown編輯器里,就可以呈現出大小不一的標題、引用、加粗、斜體等豐富的文本格式啦。

#### 為啥要學:酷炫風吸引的技術小白

某次聽講座,看到前排的江浩博士拿出電腦記筆記,打開了一個一半是黑色,一般是白色的軟體。在左邊黑色的區域內打字,打字的過程中加幾個簡單的符號,所在行的文字立馬變成了明快的彩色。更神奇的是,在右側白色區域中呈現出大小標題十分清晰的結構化文字。當時心想,這也太酷炫了吧。

&>『啥時候我也要這麼酷炫地記筆記!』

之後跟@果說的奇異果打聽這是啥軟體,他說,那就是之前給你推薦的Markdown語言啊。哦,Markdown,聽起來好高端,是不是也像Python、C啥的,也是一種編程語言呢?一定也不太好學吧。

要學習新東西,總覺得需要克服重重困難並且付出巨大的努力才行,於是借口要準備答辯,時間不充裕,就沒有馬上學起。

今年1月6號,答辯完整理電腦里的文件,想起了記憶中那個圖景。現在有時間了,沒理由不學了,那就試試看吧。

於是在維基百科上了解了Markdown的理念和語法,裝上了一個叫Mou編輯器。打開一看,對!要的就是這種酷炫的感覺!

研究了一下才發現,Markdown的語法相當簡單,一小會兒的功夫,常用的格式處理語法就都試了一遍。神奇的寫作體驗就此開始。之後的年終總結、演講稿、生活隨筆、論文思路都開始用Markdown來寫了,真是愛不釋手。

#### Markdown到底是個啥?

引用[維基百科markdown][1]上的說明,我們來看看它到底有什麼好?

Markdown是一種輕量級標記語言,創始人為John Gruber。它允許人們『使用易讀易寫的純文本格式編寫文檔,然後轉換成有效的XHTML或HTML文檔』

站在技術外行的角度簡單理解,就是以最少的輸入代價,呈現出結構化且富於表現力的文檔。寫著舒心,看著順心。

我根據自己的體驗總結了用該語言寫作的幾個好處:

* 結構寫作:通過格式標記有助於理清思路
* 語法簡單:簡單的幾個符號,試一次就可以記住
* 格式優雅:呈現出來的文字排版格式簡潔好看
* 引用方便:插入超鏈接很方便,再也不擔心找不到出處
* 寫作專註:寫作時關注內容即可,可開啟過癮的打字機聲音
* 容易分享:可導出HTML和PDF文件,隨處都可打開

#### 與Txt和Word相比呢?

大多數情況下,我們寫東西要麼用Word,要麼用Txt記事本,跟Markdown相比,這兩者的問題在哪呢?

* Txt:沒有格式,順序寫作,結構化不足,寫出來的東西所有格式都一樣。
* Word:有格式,但滑鼠鍵盤點來點去容易為格式所累,無法專註於寫作的內容本身。

而用Markdown來寫東西,既有用Txt寫作的簡潔感,也有用Word刷格式後呈現的排版效果,而且是通過簡潔的標記符號就產生了豐富的排版效果。這種感覺只有在上手用過一次以後才能了解奇妙之處。

我們常說,有什麼樣的思路,就會寫出什麼樣的東西;但我後來發現,寫作的呈現結果其實對寫作思路的影響也很大:

* 如果寫出的內容是清晰的結構化的,那麼思路也會愈發清晰;
* 如果寫出的內容是線性的非結構化的,那麼思路很容易陷入某個細節中。

還記得思維導圖嗎?如果能夠把腦海中的很多思緒用思維導圖的方式梳理和串聯起來,那麼我們會發現思路在輸出的過程中一點一點變清晰的。

#### Markdown語法好記嗎?
它不是編程語言,很簡單,一學就會,一用就靈。

常用的幾個語法:

1. **大標題小標題**:幾個#號幾級標題。如一個井號是一級標題,四個井號是四級標題。
2. **加粗和斜體**:幾對*號斜粗體。一對星號是斜體,兩對星號是加粗。
3. **引用別人的話**:一個&>號變引用。即可呈現出灰色底色引用的效果。
4. **引用鏈接**:方括弧里超鏈接。[需要引用的話][標識碼]然後把標識碼對應的鏈接附在文後:[標識碼]:http://... 或者[需要引用的話]後面緊跟括弧,括弧里是對應的鏈接。
5. **插入表格**:|號表示分割線。表格從此想怎麼畫怎麼畫。
6. **縮進黑點對齊**:一個*號點縮進。呈現黑點引導的對齊效果。
7. **縮進數字對齊**:數字圓點數縮進。呈現數字引導的對齊效果。
8. **插入高亮代碼**:三個`號插代碼。插入一段高亮代碼。
9. **插入分隔線**:三個*號分隔線。分隔線就是這麼簡單。

以上基本就是常用的語法了,可以在Markdown編輯器里試試看,半小時應該就能熟練掌握。

這些語法記不住咋辦?記性不好如我者,時不時打開工具文檔再看看唄,重複幾次,肯定就沒問題了。

#### 用什麼軟體?
Markdown是一種語言,要用Markdown語言寫作,一般來說需要一個作為編輯器的軟體。

* 如果上網方便想先試試的話,可以先不安裝編輯器,直接試試作業部落或簡書的Web端,網址是Cmd Markdown 編輯閱讀器,複製到瀏覽器中,打開即可上手來寫了。
* 如果已經決定要長期使用,不妨在本地安裝Markdown的編輯器,Mac系統推薦一個叫Mou的編輯器,親測一個月,好使。Windows系統推薦MarkdownPad或者MarkPad吧,沒用過,但可以試試看。
* 如果決定全面Markdown,那麼馬克飛象這個軟體推薦給印象筆記的用戶,可以直接寫完以後同步到筆記中哦。

這些編輯器的首頁應該都是詳細的介紹和語法說明。心動不如行動啦。

#### 用Markdown搞定微信公眾號的排版

如果你也有一個微信公眾號,只要提前裝好一個插件,那麼用Markdown寫作的文章可以直接粘在正文區,轉換一下,即可呈現豐富的格式。從此告別公眾號文章的low格式和模板格式時代。

用Markdown寫作的作者們直接寫好確認好格式,不用再經歷小編們的一道修理,就可以以原汁原味的形態,優雅地呈現於讀者面前了。小編們也可以從排版的痛苦中解放出來啦。

用Markdown來實現微信公眾號的排版包括以下幾步:

1. 裝chrome瀏覽器中安裝Markdown here插件,需要翻牆;
2. 把用Markdown寫作的文章複製過來,粘在微信後台的文本框中;
3. 按住Control+Alt+M,即可轉換成最終呈現出來的文字格式;
4. 可以進一步調整文字的顏色,插入圖片等。

這樣出來的文章,保准比之前看起來上了一個檔次哦。

#### 有了好用的工具,會不會愛上寫作呢?

**要愛上寫作,關鍵還是得寫起來。**

那麼如何克服心理障礙開始寫作呢?來自問自答幾個問題。

* 想等到想得特別成熟才動筆開始寫?放棄吧,不開始寫作,我們永遠想不成熟的;
* 怕露怯,怕不完美?放棄吧,有誰是完美的呢?列一個出來?
* 想到啥寫啥不會太low嗎?沒有low,哪有high?大師都說了,好文章是改出來的,我們首先也得有能改的東西啊。
* 千頭萬緒,沒想清楚就寫,會不會不太好?當腦海中信息太多的時候,以寫作的方式釋放出來一些,讓那些沒有頭緒的思想呈現在紙上,我們才有可能理順他們,才能給大腦留出足夠的空間關注最核心的問題吧。

好啦,開始帶著Markdown的祝福,愉快地寫起來吧。

跟我一樣,你會愛上她的。

(文章來源:果說。作者:火龍果|袁曉輝。)

[1]:Markdown

***

參考文獻:

1. 維基百科Markdown:Markdown
2. 半撇《如何在微信公眾平台上優雅的寫作》:如何在微信公眾平台上優雅的寫作


上次編輯這個答案居然是一年多前的事情了...

最近開始用馬克飛象,這是一款專門為印象筆記打造的markdown編輯器,蜜汁好用,對新手也非常友好,特此跑來安利。

官方說明語法在此:馬克飛象 - 專為印象筆記打造的Markdown編輯器

相比於其他我用過的幾款編輯器,馬克飛象的優點:

1.如果在文檔插入代碼的話,體驗非常友好,可以自定義高亮的代碼塊

2.流程圖的代碼簡潔易用,再也不用去omnigraffle畫完流程圖貼進來了

3.如果懶的下載客戶端的話,有基於chrome的離線擴展程序可以使用~還可以支持手機web

4.這是我覺得最重要的一點!它可以選擇evernote中的筆記本和標籤,還可以從evernote跳轉回馬克飛象進行編輯!!!

看看我以前混亂的md文件

語法什麼的都和其他marndown編輯器差不多,關於流程圖和LaTeX公式啥的,額外看一下就好了。語法在我一開始貼的鏈接裡面有很詳細的對照說明啦~

這裡再附贈一份基礎語法:

也歡迎各位md愛好者給我安利~么么扎!


━═┈━═┈━═┈━═┈━═我是一條不華麗的分割線 ━═┈━═┈━═┈━═┈━═


作為一隻產品狗,自從被程序猿小夥伴安利了Markdown之後,馬麻再也不用擔心我的PRD啦!
Markdown新人,首先需要選擇一款適合自己的編輯器~作為一隻合格的蘋果婊,我毫不猶豫的選擇了Macdown(一個基於OS X平台的開源編輯器)。

不多說,先上圖(學習語法的時候隨便寫的)

其實markdown的語法非常簡單,作為一隻入門的新手,想要迅速get新技能,最好的方法就是多多使用啦!寫PRD,寫日記,都可以用Markdown編輯。(不用滑鼠的感覺真的很爽啊啊啊!)

以下是我整理的Macdown基本語法啦~適合新手入門

完成一個PRD基本上只會用到這些啦,更多玩法,可以自行開發哈~

(Markdown裡面還可以插入GIf圖,親測好用 hia hia hia ~


第一次接觸Markdown的時候,被它的簡單語法和寫作體驗打動,從此我就愛上了Markdown;因為工作中經常會有記筆記和寫博客的習慣。雖然我是一名程序員,但我覺得Markdown不僅只是適用於程序員,任何需要碼字的人都會愛上他,因為通過內容來控制排版,很符號人的思維方式。

Markdown比其他編輯器的優勢:

  • 純文本內容,可適用任何編輯環境。
  • 格式是通過內容控制,很符合人的思維方式。
  • 更少的滑鼠操作,能將精力更多的放在內容上。

Markdown教程:Markdown 語法說明(簡體中文版)

Markdown的語法非常簡單,不需要幾分鐘就能了解,我一開始使用Markdown的時,經常使用四種標記符號:

  • 「#」:表示標題,根據#出現個數來區分標題級別,如:#、##、###
  • "-": 表示列表
  • "`":用這個符號包圍的內容會被高亮
  • 「```":用這個符號包圍的表示代碼塊

Markdown工具

目前有很多Markdown工具,我個人比較喜歡在web端寫東西,我就介紹關於web端的markdown工具。

簡書 - 創作你的創作

簡書應該算是小有名氣了,上面聚集很多熱愛寫作的人,它的編輯器是我最早用過的,界面乾淨、簡介。不過簡書現在首頁雞湯文泛濫,內容質量很一般,我用簡書目的只是為了自己偶爾記記筆記。

北半球

北半球是一個知識社區,更準確的說它是一個基於書籍的博客,這對於以往基於文章的博客來說很有創意,因為文章內容太零碎,而書籍對於組織筆記內容很有幫助,這裡可以在線寫書,你還可以選擇讓書籍公開或者私有。


標題

# 內容 (一級標題)
## 內容 (二級標題)
### 內容 (三級標題)
####內容 (四級標題)
#####內容 (五級標題)
###### 內容 (六級標題)

無序列表:

- 內容
- 內容
- 內容

有序列表:

1. 內容
2. 內容
3. 內容

圖片

![](圖片鏈接地址)

引用

&> 內容

粗體、斜體

粗體:**內容**
斜體:*內容*

換行、分段

  • 換行:行末加兩個或以上個空格
  • 分段:兩個回車

水平標尺

  • 三個或三個以上的星號、減號或者下劃線

http://maybeiwill.me/markdown%E7%AE%80%E6%98%93%E8%AF%AD%E6%B3%95%E5%8F%8A%E5%85%B6%E4%BB%96/


可參考我寫的《Markdown 簡明語法速成》 https://raysnote.com/markdown-get-started

順便推薦大家使用Raysnote ( http://raysnote.com )網站記筆記,非常好用:

  • 記筆記同時支持HTML富文本編輯和Markdown語法
  • 筆記支持代碼高亮(類似Github的語法高亮)
  • 筆記支持數學公式(MathJax,Latex)
  • 優雅美觀的中文排版,注重閱讀體驗
  • 一鍵保存網路文章,一致排版

剛連載完 4 篇 Markdown 文章:1)寫書,http://t.cn/RA8GJUF 2) 寫幻燈,http://t.cn/RAeVF7W 3) 寫簡歷,http://t.cn/R2VXISt 4) 寫文檔, http://t.cn/R2o3Ivf

四篇文章用到的源碼都已經整合成一個 markdown lab,基於 docker ,可一鍵構建,歡迎使用:http://tinylab.org/markdown-lab

使用截圖:


謝邀,已經有非常全面和優秀的答案了,在此補充 8 款熱門 Markdown 開發包,供大家一起交流學習。

1. 項目名稱:Markdown 編輯器 Editor.md

項目簡介:Editor.md 是一個可嵌入的開源 Markdown 在線編輯器組件,你可以很方便用在瀏覽器、NW.js(Node-webkit)等地方,基於 CodeMirror、jQuery 和 Marked 構建。

主要特性:

  • 支持「標準」 Markdown 和 Github 風格的語法,也可變身為代碼編輯器;
  • 支持實時預覽、圖片(跨域)上傳、預格式文本/代碼/表格插入、代碼摺疊、搜索替換、只讀模式、自定義樣式主題和多語言語法高亮等功能;
  • 支持 ToC(Table of Contents)、Emoji 表情、Task lists、@鏈接等 Markdown 擴展語法;
  • 支持 TeX 科學公式(基於 KaTeX)、流程圖 Flowchart 和 時序圖 Sequence Diagram;
  • 支持識別和解析 HTML 標籤,並且支持自定義過濾標籤解析,具有可靠的安全性和幾乎無限的擴展性;
  • 支持 AMD / CMD 模塊化載入(支持 Require.js Sea.js),並且支持自定義擴展插件;
  • 兼容主流的瀏覽器(IE8+)和 Zepto.js,且支持 iPad 等平板設備;

項目地址:叛道/editor.md - 碼雲

2. 項目名稱:簡潔的 Markdown 編輯器 Smark

項目簡介:說白了只是為了自己方便使用,並沒什麼新奇的東西。我使用 pandoc 來轉化 markdown,但是我不想在修改文件時總是在編輯器、文字終端和瀏覽器間換來換去,因此我寫了一個簡單的編輯器,它在後台調用 pandoc 將當前編輯的 markdown 內容轉化為 HTML,而後將 HTML 在 smark 中的瀏覽器中顯示出來,就是這麼回事。Smark 依賴於 pandoc、Qt 4.8 和 MathJax,在此向上述軟體包開發者們致敬。

主要特性:

  • Windows / Linux 等主流系統跨平台支持;
  • 完美支持 LaTex 數學公式、腳註、章節附註等,支持使用本地 MathJax 調用,不需要在線訪問 MathJax CDN;
  • 用戶可配置的 Markdown 語法高亮顯示,美觀整潔;
  • 多種格式文件導出支持,可將當前 Markdown 文件另存為 HTML、 Miscrosoft Word、OpenOffice / LibreOffice ODT Document、Latex、PDF、reStructured Text、Media Wiki markup、epub 以及 plain txt 等格式文件輸出;
  • 可通過用戶指明 CSS 文件定義顯示式樣;
  • 簡潔友好的界面布局,儘可能地凸顯正在編輯的內容;
  • 系統、完備的各類快捷鍵,極大地提高了工作效率;

項目地址:elerao/Smark - 碼雲

3. 項目名稱:Markdown 編輯器 LunarMarkdownEditor

項目簡介:Lunar Markdown Editor (LME) 是個 Markdown 編輯器,適合用來創建 CHM 文檔。

能創建 CHM 工程文件(含目錄文件、索引文件),但不能編譯 CHM, 編譯 CHM 需要另行下載微軟的 Html Help Workshop。

主要特性:

與常見 Markdown 編輯器不同:LME 走的是 IDE 的路子,適合用來製作 CHM。

  • 工作區管理

在 LME 中,首先要設置當前工作區, 然後才能創建 Markdown 文件。 創建的 Markdown 文件之間可以相互引用,只需要點點滑鼠就可以, 完全不需要用戶再手工編寫文件間的相互鏈接。

  • 圖像數據塊直接粘貼成鏈接

LME 中創建的每個 Markdown 文件都有自己的資源文件夾,其中包含一個圖像資源文件夾。 用戶可以從其它應用程序中複製一塊圖像數據,然後直接向編輯區執行「粘貼」操作, 然後 LME 會要求用戶輸入一個文件短名 ——接下來所有操作(創建資源目錄、保存圖像文件、編寫圖像鏈接字元串等)都由 LME 自動完成。

  • 圖像文件直接拖動生成鏈接

也可以從 Windows 資源管理器中直接向編輯區拖放多個圖像文件, LME 會自動生成所有鏈接,完全不需要手工編寫。

  • 編輯輔助

提供了不少查找功能,可以方便地在文件間和文件內部各元素間相互跳轉。 提供了 Markdown 文本的高亮顯示功能。 提供了 Markdown 文本的摺疊功能。 提供了大量快捷鍵。

  • Html 增強

普通 Markdown 編輯器只支持編譯靜態 Html 頁面。 而 LME 在工作區目錄下會自動創建一些資源文件(包括一些圖標、CSS文件、JS代碼文件), 這樣就可以讓編譯後的 Html 支持較豐富的功能。

項目地址:LunarSF/Lunar Markdown Editor - 碼雲

4. 項目名稱:Markdown 轉其他格式 MD2File

項目簡介:能將 markdown 語法的文檔內容,導出為 word,pdf,HTML 等的文件。

之所以使用 markdown,是因為 markdown 比較好解析,而且 md 文本的內容會比較規範。另外,html 轉md 也是比較好處理的。

目前 MD2File 支持大部分 markdown 的基本語法(支持表格語法)。無序列表和有序列表暫時還不支持多級列表。

導出的 word 文檔,在微軟的 office word 中格式是最好的,畢竟 poi 開發的時候,也是以支持 ms word 為主。在 wps 中也還不錯。在 pages 中內容排版基本正常,部分樣式不支持。導出的 pdf 文檔,相對於 word 文檔,會美觀很多。

項目地址:英強/MD2File - 碼雲

5. 項目名稱:Markdown 編輯器 Thinker-md

項目簡介:Thinker-md 是一個支持 Markdown 的在線文檔編輯器。在開發 Team@OSC 的過程中,一直在尋找一款好用的 Markdown 編輯器,縱觀所有開源的 Markdown 編輯器,要麼就是外觀簡陋,要麼就是集成繁瑣,最終找了一款比較符合要求的產品 bootstrap-markdown ,但由於在使用過程中仍然遇到一些不夠完善的地方,於是我們決定自己開發完善一個,並且開源出來,方便大家。

Thinker-md 的主要特性:

  • 支持Markdown標準和Github風格;
  • 編輯內容實時保存,刷新頁面不會丟失;
  • 支持實時預覽、圖片(跨域)上傳;
  • 支持MarkdownToHtml,HtmlToMarkdown雙向解析;
  • 支持emoji表情;
  • 多語言語法高亮;
  • 可全屏可縮小,全屏編輯體驗佳;
  • 國際化支持;
  • 極致的在線代碼編寫體驗。

項目地址:鄧海二/thinker-md - 碼雲

6. 項目名稱:Markdown 文檔生成 Markpage

項目簡介:只需一個 markpage.js 就能用 Markdown 書寫支持生成導航,表格,流程圖,時序圖,代碼高亮的 HTML 型文檔。

Markpage 讓你專註於所寫的內容,其他的資源都由 markpage 自動載入, 無需操心每次寫文檔要記憶太多的資源路徑

如果你只想簡單的用 Markdown 寫個乾淨的文檔, 比起 Word 沒有語法高亮的文檔,Markpage 會是一個不錯的選擇。

項目地址:ChineseTiger/markpage - 碼雲

7. 項目名稱:markdown 轉換 html 工具 par

項目簡介:par 是一個基於 pyPEG 寫的轉換 markdown 為 html 的工具,它是用 python 語言開發。除了支持標準的 markdown語法,還支持一些擴展語法,如 github 的 markdown 擴展及自定義的擴展,可以生成 boostrap 或 semantic-ui 的一些樣式,如: alert 或 message, tab 效果等。它主要用在 parm 項目中,實現 markdown 文檔的轉換。

項目地址:limodou/par - 碼雲

8. 項目名稱:Javascript 實現的 Markdown 解析器 Mdjs

項目簡介:Mdjs 是一個 易用 輕量級的 Javascript 實現的 Markdown 解析器。可用於 Web 前端與 Node.js 開發中,對於目前廣泛使用的 Markdown 語法均可解析(包括表格和 TOC 目錄)。

項目地址:l.y./mdjs - 碼雲

碼雲 http://Gitee.com
發現更多優質開源項目:最新推薦 - 碼雲 - 開源中國
團隊流暢、高效開發:碼雲企業版 - 碼雲 - 開源中國


我也來摻一腳:
LearnShare/Learning-Markdown · GitHub
這個項目是剛學 Markdown 的時候寫的,記錄了一些基本的語法和幾個比較優秀的工具。

另外,我也參與翻譯了 MarkdownPad2:
MarkdownPad 2 now speaks Chinese and Portuguese!
和 CuteMarkEd:
CuteMarkEd by cloose 這兩款工具。

我覺得 Markdown 雖然很 Geek,但語法上還是很簡單的,各種擴展語法也很好的豐富了 Markdown 的功能,而且現在 Markdown 的可視化編輯工具(客戶端和 Web 端都有)有很多,比較方便入門學習和日常使用。

Markdown 的優勢嘛,大概有以下幾點:
1. 基於純文本,只保留內容,很少保留額外的東西。源文件可讀可編輯,任意文本編輯器均支持(word 之類的編輯工具雖然豐富了文檔格式,但添加了許多格式化的數據,而且是私有格式,被限制在少數幾款工具中使用);
2. 在純文本的基礎上,通過簡單的標記語法(或者叫約定),即可通過程序轉換成 HTML 等其他格式的文檔;
3. 轉換程序已經遍布前後端、各種平台、各種語言了;
4. 轉換支持的格式,或間接支持的格式也有很多(HTML、word、PDF、epub 等);
5. 擴展語法豐富,能支持的功能被無限擴充(Github 的擴展就很不錯: GitHub Flavored Markdown · GitHub Help );
6. 編輯工具豐富(可以參考我的 Learning-Markdown,以及其他回復中的舉例);
7. 主流網站支持比較好(Github 等)。

用 Markdown 寫文章,不會因為要注意語法而導致寫作速度變慢,還會從它標準的格式中獲得一些方便之處:
1. 所有人、所有工具都共享統一的語法,不會出現 docx、PDF 打不開等問題;
2. 幾乎是任意工具都可以打開編輯(普通文本編輯器、Markdown 專用編輯器);
3. 產生的內容語法是一致的,方便閱讀和再編輯,共享給他人也是。


作者:LisaDou
鏈接:知乎專欄
來源:知乎
著作權歸作者所有。商業轉載請聯繫作者獲得授權,非商業轉載請註明出處。

我要的可能不僅僅針對Markdown語言,因為單就Markdown語言,你1分鐘就可以入門。關鍵是如何將Markdown很好的應用到你的工作學習生活中。

1.對於寫作你最頭疼什麼

對於大多數碼字工作者來說,隨時隨地記錄靈感,構思文章,集中書寫,其實是一件令人感到享受的事兒。當這一切都完成,為了能夠有更廣泛的讀者閱讀,需要在不同平台上發表的時候,問題就來了。

在不同的平台上發表之時,最痛苦的兩件事情莫過於:

  1. 每在一個平台發布一次,都要重新檢查調整一遍排版;
  2. 文章的所有插圖,需要在每個平台上重新上傳一份。

這?!好想shi…尤其是微信公眾號,不知道大家有沒有遇到過,用Chrome瀏覽器,在上傳圖片時經常會遇到沒有響應的時候,面對這種情況,你所付出的時間成本,以及精神成本,不言而喻。

那有沒有一種自動化的方法,當編輯完一篇文章後,不用再一次一次地解決排版問題,以及圖片上傳問題,直接可以一鍵發表到不同的內容平台?今天就給大家介紹一套我自己踐行的方法,讓你從此迎娶高富帥/白富美,實現財富自由,走上人生巔峰。喂,醒一醒…… 總之,是讓工具來解放你的生產力,你就有更多的時間用於學習思考。

2.我目前的發布流程

我目前的發布流程只需三步:

  1. 在MWeb中複製Markdown內容;
  2. 粘貼到瀏覽器中各大平台編輯器中;
  3. 按住 CTRL + ALT + M 一鍵排版,點擊發布。

圖片無需一次次重傳,10秒鐘輕鬆搞定多平台發布,是不是很心動?

別急!我們一步一步來學習。在正式操作之前,我想現針對一些基本概念和原理進行一些科普。

3. 關於Markdown及圖床的一些科普

這裡我們會用到Markdown、MWeb、圖床、七牛、Markdown Here,這些都是啥,有什麼作用,下面分別來向大家一一介紹。

3.1 為什麼使用Markdown?

學過一些HTML、CSS基礎的同學一定清楚,CSS的出現是為了使內容和樣式相分離,如果要改樣式只需改動CSS即可。同樣Markdown出現的根本目的也是使書寫內容與實際展現樣式相分離,書寫者只需更專註於書寫本身,只需通過Markdown標記語言來分清文章層次結構,而無需把過多精力浪費在重複的排版中。

首先Markdown是一門標記語言,不要害怕,你一分鐘就能入門,學習成本極低,而一旦熟悉了這種語法規則,會有一勞永逸的效果。如果你想了解更多請自行搜索。但我強烈建議你直接下載一個Markdown編輯器上手實踐就行。語法學習強迫症患者可閱讀如下鏈接。

創始人 John Gruber 的 Mardown 語法說明:
Markdown Syntax Documentation

Markdown 中文語法說明:
Markdown 語法和 MWeb 寫作使用說明

3.2 Markdown的編輯器

市面上的Markdown編輯器成千上萬,單是在少數派上搜索Markdown就能搜出一大堆。過去也使用了幾款市面口碑好的,比如Ulysses、Bear、DayOne…花高價買了Ulysses的Mac版和iOS版,在這個顏值即正義的時代,我不得不承認,這些工具都好正。但讓我一直頭疼的是圖片編輯和發布的問題。即使在編輯器里的樣式萬般嫵媚動人,到最後發布的時候依然面臨需要藉助其他工具解決圖片發布的鬧心問題,操作體驗真心不夠自動連貫。(註:之前用圖床工具iPic,單就工具來說不錯,只是整體寫作發布流程還是不夠流暢。)

有一天圖片問題甚至影響到我寫作的時候,我開始想,這個問題肯定有很多人早就遇到過,那肯定有一些解決方案,MWeb的偶遇解決這一難題,雖然其顏值可能比Ulysses和Bear在某些方面要低一些,但其對於碼字工作者實際使用場景、流程、功能的把握已經遠遠超過其他。

3.3 圖床

文章中插圖的問題怎麼解決?如果寫一篇文章,不用每次在不同的平台發表時還要重新再上傳一遍圖片,不光是上傳圖片的問題,你還要每次發布時都在原文中修改一遍圖片鏈接呢,最好的解決方式就是把圖片都上傳到一個公有伺服器,這樣所有平台發表的文章原文就可以一樣了,圖片鏈接地址就是公有伺服器上的圖片外鏈。圖床就是專門存儲這些圖片的空間,說白了就是一個圖片伺服器。

圖床的話因為之前並沒有用過太多,知乎了一下發現七牛評價最高,所以就直接註冊了七牛,並且MWeb提供對七牛的支持,至少現在感覺還不錯哦。

3.4 Markdown Here

在早先,我在使用了一段Mardown時間後,雖然Markdown在編輯器中都夠完美展現排版效果,但怎樣真正用到自己的寫作發文過程中,是我一直面臨的問題。直到有一天看到李笑來老師的一篇 Markdown Here教程才明白,哦,原來Markdown是這麼玩的。Markdown解決了內容與樣式相分離的問題,那樣式這塊,Markdown Here提供了便捷的解決方案。

Markdown Here設置界面內可以配置你希望文本渲染成的CSS樣式。你可以個性化定製你的CSS。關於自定義Markdown Here CSS樣式的問題,以後我另開專題來介紹。

接下來重點來了,要實現一鍵發布的夢想,只要完成以下前期配置操作就可以啦。

4. 工具配置 Step by Step4.1 註冊七牛並創建圖床

  1. 註冊登錄:七牛雲開發者平台官網 https://portal.qiniu.com/signin ;
  2. 添加對象存儲:「登錄首頁」→「對象存儲」→「立即添加」;
  3. 創建存儲空間:這一步就是為你創建圖床的過程。
  4. 為存儲空間命名:你需要為你的存儲空間取一個名字,可以根據你目前作品/項目名稱來命名,比如我目前的專題項目叫「整理我的人生」,那我就命名為「clearmylife」。
  5. 選擇存儲區域:根據你所在的區域或你面向讀者用戶的區域選擇一個,如果你不知道,那就選擇默認的吧。
  6. 訪問控制:這個默認為公開空間。填完之後,直接「確定創建」。至此你已經創建了屬於你自己的圖床。
  7. 另外你還要記錄3個信息,因為一會在配置MWeb圖床的時候會用到。分別是 Access Key、Secret Key(在頁面「個人面板」→「個人中心」→「秘鑰管理」中有顯示,如下圖)、圖片URL前綴(如下圖)

4.2 配置MWeb

  1. 下載安裝MWeb: 點擊MWeb官網 下載MWeb並安裝;
  2. 圖床設置:點擊右上角「分享」,在下拉菜單中選擇「把本地圖片傳至圖庫…」,點擊「新增服務」,會彈出「偏好設置—發布服務」

添加本地圖片上傳服務(圖床)

  1. 名稱:隨心所欲,你自己起個名字就行;
  2. API地址:一定要填寫你在七牛上申請存儲空間機房對應的API介面。可點擊「問號」查看詳細內容。如:華東:http://upload.qiniu.com ;華北:http://upload-z1.qiniu.com ;華南:http://upload-z2.qiniu.com 。
  3. 空間名稱:七牛開發者主頁→對象存儲→你剛剛添加的空間名稱。
  4. Access Key:「個人面板」→「個人中心」→「秘鑰管理」中AK位置,上邊讓你記錄過。
  5. Secret Key:「個人面板」→「個人中心」→「秘鑰管理」中SK位置,上邊讓你記錄過。
  6. 圖片URL前綴:「對象存儲」→「更多操作」→「內容管理」→「外鏈默認域名」,或直接複製一張你上傳圖片的外鏈,截取前綴即可。
  7. 驗證:填完之後,點擊「驗證」,如果完全按照上述步驟,你一次就能通過!至此,恭喜你,你已經成功了99%了。

4.3 配置Markdown Here

  1. 在Chrome上安裝Markdown Here插件:
  2. 安裝完後在Chrome瀏覽器右上角會出現Markdown Here插件圖標,右鍵點擊圖標,選擇選項,修改「基本渲染CSS樣式」
  3. 如果對於CSS並不了解,我建議你,先拿來主義,先嘗試,再研究。比如說,先拿來李笑來老師的版本吧 https://gist.github.com/xiaolai/aa190255b7dde302d10208ae247fc9f2 複製Github上的代碼粘貼至下圖基本渲染CSS中。
  4. 註:如何根據自己的審美修改Markdown Here CSS 樣式,後續會單開一篇文章介紹。

5. 一鍵發布

能跟著一步一步操作到這裡,不容易,原諒我的啰嗦。
接下來就是見證奇蹟的時刻啦!

  1. 在MWeb上全身心寫一篇文章(圖片直接貼,是不是感覺很爽?),寫完後,點擊「分享」→「把本地圖片傳至圖庫…」
  2. 在「選擇本地圖片自動上傳服務」的對話框中,點擊「上傳圖片」。此時你文中的圖片就全部上傳至你的七牛圖床上了。
  3. 圖片上傳完後,你會看到遠程那一行會顯示圖片遠程連接地址。

複製粘貼發布

  1. 點擊上圖「複製Markdown」(這個Markdown中本地圖片鏈接已經完全轉化為了遠程圖片鏈接);
  2. 然後打開打開微信公眾號後台素材庫的編輯器,粘貼。(不止是微信公眾號哦,簡書這些個通吃,知乎,新浪微博發表頭條樣式會有一些錯亂,需要調整下);
    3.Ctrl+Alt+M 一鍵渲染CSS樣式;

6. 為什麼微信公眾號圖片沒顯示

這時候你應該迫不及待地準備預覽發布了。

當你按照上述步驟操作後,文章保存預覽都可以清晰看到圖片,但發到手機上卻看不到,別急,由於微信後台還要將你的這些圖片重新上傳到微信的伺服器,先壓縮,再打水印,需要一些時間。

等半小時回來,在素材庫里,你預覽後發現,竟然打上水印了,恭喜你,現在群發吧~


我一直覺得Markdown的初衷就是不要學習就能使用。

*強調* **強強調**
標題
====
- item
- item
- item

這些都是英語國家人在只有純文本可用的時候默認的表達方式了。你看看那些純文本郵件組,純文本論壇,裡面的書寫規則都是這樣的。換成你,只給你純文本讓你寫英文,最後搞出來的東西估計跟這個也差不多……Markdown只是把這些已有的習俗訂成了標準而已,實現了純文本的存儲和富文本的顯示之間的轉換。

需要功能強大的時候,HTML和word(以及它的各種替代品)哪個不能比Markdown做更多的事情?甚至前幾年各種論壇上流行的BBCode,不也一樣幹得好好的?

所以看到這個問題,感到有一點……奇怪呢。一種原來設計目的就是「方便」而不是「功能強大」的玩意,到了國內如果連「方便」都做不到的話,大家跟風去用它是為了什麼呢?


作為新媒體人,在對微信運營排版的時候,普通的排版工具好像總是會出現很多反覆做工的問題。在編輯及粘貼過程中最後得到結果的時候我們總是需要進行多次修改才能達到我們想要的方式。為了提高大家的排版效率,來給大家介紹一種非常方便簡單的排版語言Markdown。

Markdown是一種用來寫作的輕量級標記語言,他用簡潔的語法代替排版,不同於我們常規在word或pages等工具中有大量的排版字體等設置。通過使用這個語言,可以使我們能夠更專註於碼字,用簡單的標記語法,代替二次的格式排版。

Markdown語法

為了讓大家更好的能夠理解Markdown語法,我們就用幾個在寫作排版中最常用的例子來展示這個語言的便捷性。

1 標題

在 Markdown 中,如果想要標記一段文字為標題,只需要在這段文字之前加#號即可。同時總共六級標題,只需如下圖類推增加#號數量即可。

2 引用

如果我們需要引用一段文字凸顯,則我們只需要在該文本前加 &> 號即可。

3 粗體與斜體

如果我們想要在文本中強調某個詞語需要加粗或斜體時,加粗我們只需要在需要加粗的詞語兩次用2個 * 號包住;斜體則是用一個* 號包裹目標文字。

4 分割線

當我們想要在文本內加入一條分割線時,只需要使用3個*號即可。

Markdown語法優點

- 專註碼字,不再費更多心思在排版樣式上。

- 純文本內容,兼容性超高。輕鬆的導出 HTML、PDF 和本身的 .md 文件。

- 隨時修改,不會出現普通文字處理軟體中生成版本排版混亂。

- 簡單,可觀,便利,簡單。

Markdown編輯器推薦

- StackEdit(在線編輯器)

- 簡書(在線編輯器)

- Typora(支持Windows/Mac/Linux系統)

- MarkdownPad(支持Windows系統)

以上就是我們此次對Markdown語言的簡單介紹,希望能夠幫助大家在排版的工作中更加便捷高效的完成。

如果想要更多了解Markdown語言,歡迎掃描二維碼加入半撇私塾的[全棧新媒體人7天成長計劃]

http://mkg201demo.bpteach.com/?utm_source=zhihu.comutm_medium=referralutm_campaign=yhy-CNM00288450utm_term=7days-grow-uputm_content=textlink (二維碼自動識別)


關鍵還是多用,熟能生巧。
上面提到的官方教程不錯的,可以按照這個語法說明一步步來學。
最後王婆賣瓜一下自己寫的語法筆記,Markdown語法筆記,僅供參考。


找到一個生成markdown表格的網站,可以方便的從excel複製表格,然後在網頁上粘貼,生成markdown格式的表格,可以大幅提高生產效率:http://www.tablesgenerator.com/markdown_tables


為什麼沒人推薦這個:Haroopad


typora。http://www.typora.io
用過都說好


當我前段時間學習 Markdown 的時候,我把該問答下幾乎所有的答案都看了

現如今,我看過的最適合新手學習的、最明了易懂的文章教程應該是這篇:
Markdown簡明教程:碼字效率飛升80%,不懂代碼也能hold住!
其實 Markdown 真是簡單到一篇短文的閱讀時間就上手了。之後就請享受純文本碼格式的快感吧!

如果你喜愛寫作,應該值得為此購買一款得力的生產力 APP,我推薦 Ulysses (在 Mac 上 ¥283),(在 iOS 上 ¥163)

大部分的 Markdown 編輯器寫與讀都是如下(iA Writer、Ulysses)的簡單源碼模式,也就是說讀文檔時你也會看到 ### ** _ &> 這些字元,坦白講其實它對大篇幅的閱讀還是有一定的干擾的。

所以你可以試試文中推薦的所見即所得軟體:
我想你需要這個簡單好用的 Markdown 閱讀器


推薦閱讀:

怎樣靠寫文章一個月掙到 2000 塊?
以「說出來你可能不相信,我是一條龍」為開頭,可以寫出怎樣的故事?
若啟用電影分級制代替審查制,會對中國電影產生多大的影響?

TAG:寫作 | 在線論壇 | Markdown | 標記語言 |