用markdown寫下你的第一個md文檔

追溯 markdown 這個詞的來源,應該是為了致敬編寫網頁所用的HTML(Hyper Text Markup Language 超文本標記語言)中的 markup,我猜...

markdown是什么?

同HTML一樣,markdown也是一種標記語言,但與HTML相比,簡直不能再簡單!這主要體現在兩個地方:

  • 標記符的數量,HTML文檔需要用到數量繁多的標記符,再輔以CSS來控制樣式和排版,而markdown文檔只需要四個基本的標記符號就能完成同樣的事。
  • 標記符的書寫。HTML文檔內容需要同時標記開始和結束<html><body>這是一個網頁</body></html>,而markdown文檔則只要在開始位置標記即可# 這是一個md文檔

markdown用來干嘛?

主要是用來解決文檔快速排版快速讀取的問題。當我們需要讓文檔看起來層次分明,但又想不依賴于像Word這樣的重型編輯工具來書寫、排版和讀取時,markdown易寫易讀的優勢就非常明顯了。

并且在我使用一段時間后,發現markdown的編寫方式還有助于作者快速梳理邏輯思路和文章層次。

怎樣書寫和讀取markdown?

同HTML一樣,你可以使用任何一款純文本編輯工具(如記事本)來編輯和讀取包含markdown格式的文本,但只有在一些網站(如簡書)或者工具(如有道云筆記)下,才能呈現出美觀的渲染樣式。

當然,markdown也可以使用HTML的標記符來控制格式和排版,這意味著,你即可以使用標準的markdown語法,也可以在其中嵌入HTML標記符,但只有一小部分會起作用。

你現在看到這篇文章就完全由markdown書寫。

markdown語法

我再次強調,真的非常簡單!花幾分鐘跟隨我熟悉一下語法,相信你也可以馬上寫出你的第一個markdown文檔。

  • 基本符號* - + >

    你只需要記住這四個基本符號就能控制文檔的排版和樣式,因為基本上所有的markdown標記都是基于這四個符號及其組合。需要注意的是,基本符號后有一個用于分割標記符和內容的空格

  • 標題(從大到小取決于#號的數量)

    • 一級標題 # 一級標題

    • 二級標題 ## 二級標題

    • 三級標題 ### 三級標題

    • 四級標題 #### 四級標題

    • 五級標題 ##### 五級標題
    • 六級標題 ###### 六級標題
  • 正文

    換行以后直接開始書寫,不用加任何符號。

  • 段落

    一個段落以一個自然的 回車 作為換行分隔。

  • 字體樣式

    • 傾斜 *傾斜*
    • 加粗 **加粗**
    • 傾斜并加粗 ***傾斜并加粗***
    • 文字刪除線 ~~文字刪除線~~
  • 引用

    這是一段引用 > 引用內容

  • 分隔符

    • 連續輸入三個以上的 --- 添加分隔符,下面就會出現一條橫線:

  • 列表

    • 無序列表

    使用 * - + 中的任何一個符號加空格就可以創建無序列表,但如我這樣的強迫癥患者完美主義者可以進一步使用+-來表現層次關系。

    * 這是一個無序列表
    * 這是一個無序列表
    
    + 這是一個父無序列表
      - 這是一個子無序列表
    
    • 有序列表

    使用 數字+點+空格+內容 創建有序列表。

    1. 這是一個有序列表
    2. 這是一個有序列表
    3. 這是一個有序列表
      1. 這是一個嵌套有序列表
      2. 這是一個嵌套有序列表
      3. 這是一個嵌套有序列表
    

    列表可以嵌套,使用時在嵌套列表前按 tab空格 來控制縮進。如你所見,這篇文章的排版就使用了嵌套列表的樣式。

  • 鏈接

    [用markdown寫下你的第一個md文檔](http://www.lxweimin.com/p/de9c98bba332) 
    
    • 也可以直接用尖括號包含網址的方式<http://www.lxweimin.com>來直接構造一個可點擊的鏈接 http://www.lxweimin.com
  • 圖片

    像構造一個鏈接一樣,只需要在前面加!

    ![圖片名稱](圖片地址)
    
    簡書
  • 代碼

    markdown也常用來編寫代碼文檔,因此文檔中引入代碼必不可少。

    • 代碼塊

    使用 ` 符號包裹代碼構建一個代碼塊,` 符號在左上角esc鍵下方,請在半角狀態輸入。一些markdown工具支持更簡單的按tab縮進方式。
    console.log('這是一個代碼塊');

    • 代碼段

    使用
    ```
    代碼段
    ```
    這樣的方式來構建一個多行的代碼段。

    print("這是一個")
    print("由markdowns標記符構成")
    print("多行代碼段")
    
  • 表格

    • 使用- |符號把內容分割為你認為合適的表格樣式就好。
    • 使用:符號標識對齊。
    表頭1|表頭2|表頭3
    :----|:-----:|-----:
    左對齊|居中對齊|右對齊
    
    表頭1 表頭2 表頭3
    左對齊 居中對齊 右對齊
  • 保存

    最后將markdown編寫的文檔存為 .md 格式,就可以用對應的工具查看效果和編輯了。

  • 怎樣在簡書開始書寫你的第一個markdown文檔?

    1. 首先你要注冊一個賬號
    2. 然后點擊右上角 寫文章
    3. 點擊右下腳角 設置
    4. 默認編輯器選擇 MarkDown編輯器
    5. 最后 新建文章
最后編輯于
?著作權歸作者所有,轉載或內容合作請聯系作者
平臺聲明:文章內容(如有圖片或視頻亦包括在內)由作者上傳并發布,文章內容僅代表作者本人觀點,簡書系信息發布平臺,僅提供信息存儲服務。
  • 序言:七十年代末,一起剝皮案震驚了整個濱河市,隨后出現的幾起案子,更是在濱河造成了極大的恐慌,老刑警劉巖,帶你破解...
    沈念sama閱讀 230,501評論 6 544
  • 序言:濱河連續發生了三起死亡事件,死亡現場離奇詭異,居然都是意外死亡,警方通過查閱死者的電腦和手機,發現死者居然都...
    沈念sama閱讀 99,673評論 3 429
  • 文/潘曉璐 我一進店門,熙熙樓的掌柜王于貴愁眉苦臉地迎上來,“玉大人,你說我怎么就攤上這事。” “怎么了?”我有些...
    開封第一講書人閱讀 178,610評論 0 383
  • 文/不壞的土叔 我叫張陵,是天一觀的道長。 經常有香客問我,道長,這世上最難降的妖魔是什么? 我笑而不...
    開封第一講書人閱讀 63,939評論 1 318
  • 正文 為了忘掉前任,我火速辦了婚禮,結果婚禮上,老公的妹妹穿的比我還像新娘。我一直安慰自己,他們只是感情好,可當我...
    茶點故事閱讀 72,668評論 6 412
  • 文/花漫 我一把揭開白布。 她就那樣靜靜地躺著,像睡著了一般。 火紅的嫁衣襯著肌膚如雪。 梳的紋絲不亂的頭發上,一...
    開封第一講書人閱讀 56,004評論 1 329
  • 那天,我揣著相機與錄音,去河邊找鬼。 笑死,一個胖子當著我的面吹牛,可吹牛的內容都是我干的。 我是一名探鬼主播,決...
    沈念sama閱讀 44,001評論 3 449
  • 文/蒼蘭香墨 我猛地睜開眼,長吁一口氣:“原來是場噩夢啊……” “哼!你這毒婦竟也來了?” 一聲冷哼從身側響起,我...
    開封第一講書人閱讀 43,173評論 0 290
  • 序言:老撾萬榮一對情侶失蹤,失蹤者是張志新(化名)和其女友劉穎,沒想到半個月后,有當地人在樹林里發現了一具尸體,經...
    沈念sama閱讀 49,705評論 1 336
  • 正文 獨居荒郊野嶺守林人離奇死亡,尸身上長有42處帶血的膿包…… 初始之章·張勛 以下內容為張勛視角 年9月15日...
    茶點故事閱讀 41,426評論 3 359
  • 正文 我和宋清朗相戀三年,在試婚紗的時候發現自己被綠了。 大學時的朋友給我發了我未婚夫和他白月光在一起吃飯的照片。...
    茶點故事閱讀 43,656評論 1 374
  • 序言:一個原本活蹦亂跳的男人離奇死亡,死狀恐怖,靈堂內的尸體忽然破棺而出,到底是詐尸還是另有隱情,我是刑警寧澤,帶...
    沈念sama閱讀 39,139評論 5 364
  • 正文 年R本政府宣布,位于F島的核電站,受9級特大地震影響,放射性物質發生泄漏。R本人自食惡果不足惜,卻給世界環境...
    茶點故事閱讀 44,833評論 3 350
  • 文/蒙蒙 一、第九天 我趴在偏房一處隱蔽的房頂上張望。 院中可真熱鬧,春花似錦、人聲如沸。這莊子的主人今日做“春日...
    開封第一講書人閱讀 35,247評論 0 28
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽。三九已至,卻和暖如春,著一層夾襖步出監牢的瞬間,已是汗流浹背。 一陣腳步聲響...
    開封第一講書人閱讀 36,580評論 1 295
  • 我被黑心中介騙來泰國打工, 沒想到剛下飛機就差點兒被人妖公主榨干…… 1. 我叫王不留,地道東北人。 一個月前我還...
    沈念sama閱讀 52,371評論 3 400
  • 正文 我出身青樓,卻偏偏與公主長得像,于是被迫代替她去往敵國和親。 傳聞我的和親對象是個殘疾皇子,可洞房花燭夜當晚...
    茶點故事閱讀 48,621評論 2 380

推薦閱讀更多精彩內容

  • 為什么學習Markdown 自從搭建了 Hexo 博客之后,發現還有 Markdown 這種寫文章的方法,想到以后...
    lifeColder閱讀 20,178評論 10 216
  • 轉抄日期:2016年06月05日 中文原文地址:http://www.markdown.cn 英文原文地址:ht...
    ChristieIn閱讀 907評論 0 1
  • tags: Hexo;Github;Markdowncategories: 前端工具歡迎點擊我的博客原文 Mark...
    淺茉Sara閱讀 1,715評論 1 5
  • Markdown是一種輕量級的[標記語言],它的優點很多,目前也被越來越多的寫作愛好者,撰稿者廣泛使用。看到這里請...
    李阿昀閱讀 18,947評論 1 18
  • 我不會寫詩,也許大多數人也不會寫詩,雖然我們羨慕詩人,但這并不代表我們要詩人進發。 我不會寫詩,可是我踏實地生活,...
    輕水先生閱讀 300評論 0 0