Markdown 學(xué)習(xí)筆記·入門


Markdown 學(xué)習(xí)筆記·入門

花一點(diǎn)點(diǎn)時(shí)間了解了下Markdown的語(yǔ)法,確實(shí)非常簡(jiǎn)單,這里做下總結(jié),也算是對(duì)Markdown語(yǔ)法的熟悉,及模仿造輪子吧~

markdown 簡(jiǎn)介

Markdown是一種可以使用普通文本編輯器編寫的標(biāo)記語(yǔ)言,通過(guò)簡(jiǎn)單的標(biāo)記語(yǔ)法,它可以使普通文本內(nèi)容具有一定的格式。
Markdown具有一系列衍生版本,用于擴(kuò)展Markdown的功能(如表格、腳注、內(nèi)嵌HTML等等),這些功能原初的Markdown尚不具備,它們能讓Markdown轉(zhuǎn)換成更多的格式,例如LaTeX,Docbook。Markdown增強(qiáng)版中比較有名的有Markdown Extra、MultiMarkdown、 Maruku等。這些衍生版本要么基于工具,如Pandoc;要么基于網(wǎng)站,如GitHub和Wikipedia,在語(yǔ)法上基本兼容,但在一些語(yǔ)法和渲染效果上有改動(dòng)。--百度百科

特點(diǎn)總結(jié)

  • 純文本,所以兼容性極強(qiáng),可以用所有文本編輯器打開。
  • 讓你專注于文字而不是排版。
  • 格式轉(zhuǎn)換方便,Markdown 的文本你可以輕松轉(zhuǎn)換為 html、電子書等。
  • Markdown 的標(biāo)記語(yǔ)法有極好的可讀性。

Markdown 語(yǔ)法介紹

基本符號(hào)

  • *,-,+ 3個(gè)符號(hào) 被稱為Markdown符號(hào)
  • 空白行表示另起一個(gè)段落
  • `是表示inline代碼,tab是用來(lái)標(biāo)記 代碼段,分別對(duì)應(yīng)html的code,pre標(biāo)簽

標(biāo)題

  • # + 空格 后面的文字即表示為標(biāo)題

      # 表示一級(jí)標(biāo)題,## 表示二級(jí)標(biāo)題,依次表示 1-6 級(jí)標(biāo)題
    
  • 注意: 符號(hào)后面要加一個(gè) 空格 和文本內(nèi)容隔開

  • 還可以在文字下行加= 表示大標(biāo)題 - 表示小標(biāo)題 慎用吧

      例如:
      大標(biāo)題
      =
      小標(biāo)題
      -
    

字體:斜體 / 加粗

*文本* 表示文本內(nèi)容為斜體, **文本** 表示文本內(nèi)容為斜體
  • 效果: 斜體文本 加粗文本

換行

  • 段落間加一個(gè) 空白行 分割 同html中的 <p>
  • 連續(xù)兩個(gè)空格即為換行 同html中的 <br>

列表

  • 使用*,+,-加上一個(gè)空格來(lái)表示

  • 可以支持嵌套,如

      *,+,-效果一樣的
      - 外層列表項(xiàng)目
            + 內(nèi)層列表項(xiàng)目
           + 內(nèi)層無(wú)序列表項(xiàng)目
          + 內(nèi)層列表項(xiàng)目
      - 外層列表項(xiàng)目
    
  • 效果


  • 外層列表項(xiàng)目
    • 內(nèi)層列表項(xiàng)目
    • 內(nèi)層列表項(xiàng)目
    • 內(nèi)層列表項(xiàng)目
  • 外層列表項(xiàng)目

  • 有序列表用 數(shù)字+英文點(diǎn)+空格來(lái)表示

      - 1. 這樣會(huì)展示序號(hào) 
    
  • 效果:

    1. 這樣會(huì)展示序號(hào)
  • 注意:列表內(nèi)容很長(zhǎng)的,不需要手工輸入換行符,css控制段落的寬度,會(huì)自動(dòng)的縮放的

鏈接

  • 這其實(shí)是我第一個(gè)接觸的markdown語(yǔ)法,第一篇資料收集時(shí)就用到了

       直接使用 [文本](鏈接)
    
  • 效果:百度

       如果很多地方需要相同的url呢,可以預(yù)先定義url 這樣玩:[ref_name]:URL  ref_name 一般使用數(shù)字表示,顯得專業(yè) 然后在需要使用鏈接的地方 使用[文本][ref_name] 這種方式即可,酷炫
    
  • 效果
    [1]:https://www.baidu.com/

        [ref_name]:url 如: [1]:https://www.baidu.com/ 
    
  • 引用上面定義的url [百度][1]

  • 如果想把URL展示出來(lái),并可以作為鏈接使用 這樣玩:<URL>

        <url> 如: <https://www.baidu.com/> 
    
  • 效果:https://www.baidu.com/

圖片

  • 圖片語(yǔ)法與鏈接類似

      ![](圖片地址) 如: ![](http://i.imgur.com/P7ACmyM.png)
    
  • 同樣可以使用引用的方式使用圖片

      這樣定義:[id]:圖片url  這樣引用定義 ![][id]
    
  • 定義圖片的大小或比例

  • 方法一:嵌入HTML代碼

          <img src="./xxx.png" width = "300" height = "200" alt="圖片名稱" align=center /> 注意:要居中展示,外圍加<div>即可
    
  • 方法二:使用支持圖片大小更改操作的 Mou 編輯器 (mac可以玩)

           ![](url =100x100) 注意: =前有個(gè)空格,可以只寫寬度。         
    
  • 方法三: 阿里云的OSS,七牛云的圖片服務(wù)器時(shí),url上加上相關(guān)操字段即可實(shí)現(xiàn)圖片大小,比例修改,具體見各自的產(chǎn)品文檔~

引用

  • 開篇關(guān)于Markdown的簡(jiǎn)介和特點(diǎn)就是引用的百度, 只要在第一行加上 “>”和一個(gè)空格,表示代碼引用,還可以嵌套

轉(zhuǎn)義

  • 使用 \ 來(lái)轉(zhuǎn)義,表示文本中的markdown符號(hào)

      如: \[百度](https://www.baidu.com/)
    
  • 效果:[百度](https://www.baidu.com/)

表格

  • 表格代碼

| Tables | Are | Cool |
| ------------- |:-------------:| -----:|
| col 3 is | right-aligned | $1600 |
| col 2 is | centered | $12 |
| zebra stripes | are neat | $1 |

 ------------- 左對(duì)齊 :-------------: 居中 -----:右對(duì)齊
  • 效果:
Tables Are Cool
col 3 is right-aligned $1600
col 2 is centered $12
zebra stripes are neat $1

代碼塊

  • 按下Tab鍵 或4個(gè)空格即表示代碼塊
    C#:

    //這里顯示一些代碼,在正文顯示中會(huì)自動(dòng)識(shí)別語(yǔ)言,進(jìn)行代碼染色,這是一段C#代碼
    public class Blog
    {
         public int Id { get; set; }
         public string Subject { get; set; }
    }

這樣基本就可以玩起來(lái)了,還是需要多實(shí)踐,多謝,多總結(jié)。

我們活在各自的的心靈世界,我們有什么樣的心,就決定我們看到什么樣的世界

最后編輯于
?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請(qǐng)聯(lián)系作者
【社區(qū)內(nèi)容提示】社區(qū)部分內(nèi)容疑似由AI輔助生成,瀏覽時(shí)請(qǐng)結(jié)合常識(shí)與多方信息審慎甄別。
平臺(tái)聲明:文章內(nèi)容(如有圖片或視頻亦包括在內(nèi))由作者上傳并發(fā)布,文章內(nèi)容僅代表作者本人觀點(diǎn),簡(jiǎn)書系信息發(fā)布平臺(tái),僅提供信息存儲(chǔ)服務(wù)。

相關(guān)閱讀更多精彩內(nèi)容

  • 為什么學(xué)習(xí)Markdown 自從搭建了 Hexo 博客之后,發(fā)現(xiàn)還有 Markdown 這種寫文章的方法,想到以后...
    lifeColder閱讀 20,437評(píng)論 10 216
  • Markdown 語(yǔ)法 以下是 Markdown 的常用語(yǔ)法!在以后的筆記中將持續(xù)使用 Markdown 語(yǔ)法進(jìn)行...
    WinSolstice閱讀 1,579評(píng)論 0 1
  • 去年中秋未折花,以為花隨余香去。 忽見桂子壓枝低,秋花春實(shí)惟一樹。 2017年4月10日江邊手機(jī)攝
    遠(yuǎn)曉閱讀 405評(píng)論 0 3
  • 我愛你!
    a0e7cb82012e閱讀 126評(píng)論 0 1

友情鏈接更多精彩內(nèi)容