1. 程式人生 > 其它 >Markdown 語法總結

Markdown 語法總結

技術標籤:文件編輯markdownsublime text

前言

Markdown是一種輕量級標記語言。它允許人們使用易讀易寫的純文字格式編寫文件,然後轉換成有效的XHTML(或者HTML)文件。

常規

Markdown的常規語法可於其 線上編輯器 MdEditor 亦或是CSDN自帶的編輯器中瞭解學習,這裡不做贅述。

該線上編輯器的介面如下所示:

mdeditor

擴充

1、新增圖片

圖片的常規新增方式為圖片相應路徑 / 連結的提供(本地路徑亦或是網路連結),但考慮到實際中的需求,以及應對諸如本地圖片誤刪、連結失效等潛在因素,小佚在這裡推薦一種新的新增圖片的方式 —— 將圖片轉成Base64編碼再寫入md文件中

  • 將本地圖片匯入 線上轉碼工具 Jsons.cn 後複製所生成的Base64編碼;
  • 將編碼貼上到原圖片路徑 / 連結中的位置;
    - 普通連結:
        - ![圖片名稱](所複製的編碼內容)

    - 錨點連結:
        - ![圖片名稱][錨點名稱]
        - [錨點名稱]:所複製的編碼內容

[溫馨提示:建議使用錨點連結,以便將編碼(字串)置於文件底部 —— 一張350KB大小的圖片大概會有48萬個字元,所佔篇幅極為誇張,倘若放置在正文中會形成斷層,影響編輯,體驗極差!]

2、錨點定位

在文章篇幅過長,亦或是有著特殊需求的情況下,我們會希望當前文章能夠具備錨點定位的功能。小佚在線上編輯器的語法示例中並沒有看到此功能,特意在這裡提下。

    - [自定義內容](#錨點名稱)
    - <a id="錨點名稱">自定義內容</a>

3、未完待續 ……