md文件怎么用,md 文件編寫規則

md是簡稱 , 它的全名為MARKDOWN 。Markdown是一種可以使用普通文本編寫的標記語言 , 通過簡單的標記語法 , 它可以使普通文本內容具有一定的格式 。Markdown具有一系列衍生版本 , 用于擴展Markdown的功能(如表格、腳注、內嵌HTML等等) , 這些功能原初的Markdown尚不具備 , 它們能讓Markdown轉換成更多的格式 , 例如LaTeX , Docbook 。Markdown增強版中比較有名的有Markdown Extra、MultiMarkdown、 Maruku等 。這些衍生版本要么基于工具 , 如Pandoc;要么基于網站 , 如GitHub和Wikipedia , 在語法上基本兼容 , 但在一些語法和渲染效果上有改動 。
一、md文件的查看方式
1、windows下可以安裝markdownpad來打開md文件 。下載地址:***/download.html
2、ubuntu下則可安裝retext , 用命令: retext xxx.md 查看
二、md文件的寫法
1、標題
1)規范的README文件開頭都寫上一個標題 , 這被稱為大標題 。

  • 大標題
  • ====
  • 在文本下面加上 等于號 =  , 上方的文本就變成了大標題 。等于號的個數無限制 , 但一定要大于0個 。
    如果你只輸入了等于號= , 但其上方無文字 , 那么就只會顯示一條直線 。如果上方有了文字 , 但你又只想顯示一條橫線 , 而不想把上方的文字轉義成大標題的話 , 那么你就要在等于號=和文字直接補一個空行 。
    2)比大標題低一級的是中標題 , 也就是顯示出來比大標題小點 。
  • 中標題
  • -------
  • 在文本下面加上 下劃線 -  , 那么上方的文本就變成了中標題 , 同樣的 下劃線個數無限制 。
    3)標題還有等級表示法 , 分為六個等級 , 顯示的文本大小依次減小 。不同等級之間是以井號 # 的個數來標識的 。一級標題有一個 # , 二級標題有兩個#  , 以此類推 。
    1. #一級標題
    2. ##二級標題
    3. ###三級標題
    4. ####四級標題
    5. #####五級標題
    6. ######六級標題
    注意井號#和標題名稱要并排寫作一行 , 顯示效果如圖:
    md文件怎么用,md 文件編寫規則

    文章插圖
    2、顯示文本
    1)普通文本
    直接輸入的文字就是普通文本 。需要注意的是要換行的時候不能直接通過回車來換行 , 需要使用<br>(或者<br/>) 。也就是html里面的標簽 。事實上 , markdown支持一些html標簽 。當然如果你完全使用html來寫的話 , 就喪失意義了 , 畢竟markdown并非專門做前端的 , 然而僅實現一般效果的話 , 它會比html寫起來要簡潔得多得多啦 。
    怎么樣顯示普通文本呢 , 
    這樣顯示可以不 , <br>
    還是要這樣\<br>
    注意第三行的<br>前加了反斜杠 \。目的就是像其他語言那樣實現轉義 , 也就是 < 的轉義 。
    【md文件怎么用,md 文件編寫規則】效果如圖:
    md文件怎么用,md 文件編寫規則

    文章插圖
    2)單行文本
    使用兩個Tab符實現單行文本 。
    1. 這是單行文本示例
    注意前面有兩個Tab 。在GitHub上單行文本顯示效果如圖:
    md文件怎么用,md 文件編寫規則

    文章插圖
    3)多行文本
    多行文本和單行文本異曲同工 , 只要在每行行首加兩個Tab
    1. 這是一個多行文本示例:
    2. 就是這么簡單 , 
    3. 試試吧
    多行文本顯示效果:
    md文件怎么用,md 文件編寫規則

    文章插圖
    4)部分文字的高亮
    如果你想使一段話中部分文字高亮顯示 , 來起到突出強調的作用 , 那么可以把它用 ` ` 包圍起來 。注意這不是單引號 , 而是Tab上方 , 數字1左邊的按鍵(注意使用英文輸入法) 。
    高亮`字示`例`哦`!
    文字顯示效果:
    md文件怎么用,md 文件編寫規則

    文章插圖
    5)縮進
    文字開頭使用>號
    >目錄
    >>第一卷
    >>>第一章
    >>>>第一小節
    >>>>>第一回合
    示例顯示效果:
    md文件怎么用,md 文件編寫規則

    文章插圖
    當然md文件的用法還有很多 , 這里就不一一示例了 , 總的來說md文件使用簡單 , 格式也比一般文本豐富 。
    以 md 結尾的文件 , 其實就是 Markdown 文件 。而 Markdown 是一種可以使用普通文本編寫的編輯語言 , 可以通過標記語法 , 使普通文本內容具有一定的格式 。
    Markdown 語法簡介命令 , 容易學習 , 比純文本強 , 也有一部分開發者使用其來寫博客 。另外 , 像項目的 README 文件 , 一般都是 md 文件 , 都是用 Markdown 語法編寫的 , 其效果如下圖所示:
    md文件怎么用,md 文件編寫規則

    文章插圖
    基本語法
    下面簡單介紹一下 Markdown 的語法 。
    標題
    以 # 開頭 , 1個代表一級標題 , 2個代表二級標題 , 以此類推 , 一直到六級標題 。
    md文件怎么用,md 文件編寫規則

    文章插圖
    斜體
    一個 * 或者 _ 包括 , 如 * 斜體 *、_斜體_ 。
    md文件怎么用,md 文件編寫規則

    文章插圖
    加粗
    兩個連續的 * 或者 _ 包括 , 如 * 加粗 *、__加粗__ 。
    md文件怎么用,md 文件編寫規則

    文章插圖
    有序列表
    以 數字. 開頭 , 如 1. 、2.、3. 、4. 等
    md文件怎么用,md 文件編寫規則

    文章插圖
    無序列表
    以 *、+、- 開頭 , 其效果相同 。
    md文件怎么用,md 文件編寫規則

    文章插圖
    嵌套列表
    以 *、+、- 開頭嵌套使用 , 其效果相同 。
    md文件怎么用,md 文件編寫規則

    文章插圖
    效果如下:
    md文件怎么用,md 文件編寫規則

    文章插圖
    引用
    以 > 開頭 , 即代表引用內容 。
    md文件怎么用,md 文件編寫規則

    文章插圖
    效果如下:
    md文件怎么用,md 文件編寫規則

    文章插圖
    嵌套引用
    下級引用在上級引用基礎上 , 多加一個 > 。如圖所示:
    md文件怎么用,md 文件編寫規則

    文章插圖
    效果如下:
    md文件怎么用,md 文件編寫規則

    文章插圖
    代碼塊
    單行代碼 , 用 ` 包括即可 。
    md文件怎么用,md 文件編寫規則

    文章插圖
    效果如圖:
    md文件怎么用,md 文件編寫規則

    文章插圖
    多行代碼 , 用 ``` 包括 。
    md文件怎么用,md 文件編寫規則

    文章插圖
    效果如下:
    md文件怎么用,md 文件編寫規則

    文章插圖
    鏈接
    格式為:[<文本>](地址 title) , 注意 , 地址和文本title空一格;title帶雙引號 。
    md文件怎么用,md 文件編寫規則

    文章插圖
    效果如下:
    md文件怎么用,md 文件編寫規則

    文章插圖
    圖片
    圖片的引入方式類似于鏈接 , 格式為:![<文本>](地址 title) , 注意 , 地址和文本title空一格;title帶雙引號 。
    md文件怎么用,md 文件編寫規則

    文章插圖
    應用首選Typora , 輕量、簡潔、易用、免費 。且支持多種模式 , 如打印機模式、專注模式、側邊欄等等 。
    md文件怎么用,md 文件編寫規則

    文章插圖
    在線首選 mdeditor , 實時預覽 , 無需安裝 。
    md文件怎么用,md 文件編寫規則

    文章插圖

      推薦閱讀