Markdown 學習筆記·入門


Markdown 學習筆記·入門

花一點點時間了解了下Markdown的語法,確實非常簡單,這里做下總結,也算是對Markdown語法的熟悉,及模仿造輪子吧~

markdown 簡介

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

特點總結

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

Markdown 語法介紹

基本符號

  • *,-,+ 3個符號 被稱為Markdown符號
  • 空白行表示另起一個段落
  • `是表示inline代碼,tab是用來標記 代碼段,分別對應html的code,pre標簽

標題

  • # + 空格 后面的文字即表示為標題

      # 表示一級標題,## 表示二級標題,依次表示 1-6 級標題
    
  • 注意: 符號后面要加一個 空格 和文本內容隔開

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

      例如:
      大標題
      =
      小標題
      -
    

字體:斜體 / 加粗

*文本* 表示文本內容為斜體, **文本** 表示文本內容為斜體
  • 效果: 斜體文本 加粗文本

換行

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

列表

  • 使用*,+,-加上一個空格來表示

  • 可以支持嵌套,如

      *,+,-效果一樣的
      - 外層列表項目
            + 內層列表項目
           + 內層無序列表項目
          + 內層列表項目
      - 外層列表項目
    
  • 效果


  • 外層列表項目
    • 內層列表項目
    • 內層列表項目
    • 內層列表項目
  • 外層列表項目

  • 有序列表用 數字+英文點+空格來表示

      - 1. 這樣會展示序號 
    
  • 效果:

    1. 這樣會展示序號
  • 注意:列表內容很長的,不需要手工輸入換行符,css控制段落的寬度,會自動的縮放的

鏈接

  • 這其實是我第一個接觸的markdown語法,第一篇資料收集時就用到了

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

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

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

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

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

圖片

  • 圖片語法與鏈接類似

      ![](圖片地址) 如: ![](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) 注意: =前有個空格,可以只寫寬度。         
    
  • 方法三: 阿里云的OSS,七牛云的圖片服務器時,url上加上相關操字段即可實現圖片大小,比例修改,具體見各自的產品文檔~

引用

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

轉義

  • 使用 \ 來轉義,表示文本中的markdown符號

      如: \[百度](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 |

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

代碼塊

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

    //這里顯示一些代碼,在正文顯示中會自動識別語言,進行代碼染色,這是一段C#代碼
    public class Blog
    {
         public int Id { get; set; }
         public string Subject { get; set; }
    }

這樣基本就可以玩起來了,還是需要多實踐,多謝,多總結。

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

最后編輯于
?著作權歸作者所有,轉載或內容合作請聯系作者
平臺聲明:文章內容(如有圖片或視頻亦包括在內)由作者上傳并發布,文章內容僅代表作者本人觀點,簡書系信息發布平臺,僅提供信息存儲服務。

推薦閱讀更多精彩內容

  • 為什么學習Markdown 自從搭建了 Hexo 博客之后,發現還有 Markdown 這種寫文章的方法,想到以后...
    lifeColder閱讀 20,194評論 10 216
  • Markdown 語法 以下是 Markdown 的常用語法!在以后的筆記中將持續使用 Markdown 語法進行...
    WinSolstice閱讀 1,503評論 0 1
  • 去年中秋未折花,以為花隨余香去。 忽見桂子壓枝低,秋花春實惟一樹。 2017年4月10日江邊手機攝
    遠曉閱讀 356評論 0 3
  • 我愛你!
    a0e7cb82012e閱讀 114評論 0 1