MarkDown使用教程


前言

  以前經常在 github 中看到 .md 格式的文件,一直沒有注意,也不明白為什么文本文檔的后綴不是 .txt ,后來無意中看到了 Markdown,看到了用這個東西寫得一些web界面等特別的規整漂亮,頓時不明覺厲。后來自己學習了一下,感覺這個語言確實簡潔、美觀,現推薦出來供大家學習和玩玩,希望能對你有用。

  本文圖文並茂,避免了單純看語法的枯燥和繁瑣,其實,學習一門新東西真的其樂無窮!

簡介

Markdown 是一種用來文本處理的輕量級 「標記語言」,它用簡潔的語法代替排版,而無需像Microsoft的Word一樣需要花費大量的時間進行排版、字體設置。它使我們專心於碼字,用「標記」語法,來代替常見的排版格式。Markdown不止可以處理文本,使得文字更美觀,還支持圖像、表格等的插入,大大方便了我們的寫作。例如此文從內容到格式,甚至插圖,一個鍵盤可以搞定了,無需鼠標!

  目前來看,支持 Markdown 語法的編輯器有很多,包括很多網站(例如簡書)也支持了 Markdown 的文字錄入。Markdown 從寫作到完成,導出格式隨心所欲,你可以導出 HTML 格式的文件用來網站發布,也可以十分方便的導出 PDF 格式,甚至可以利用 CloudApp 這種雲服務工具直接上傳至網頁用來分享你的文章,全球最大的輕博客平台 Tumblr,也支持 Mou 這類 Markdown 工具的直接上傳。

  目前,我們的 博客園 同樣支持了Markdown文本的編輯,具體如何設置請往下看!

Markdown特點

  • 專注你的文字內容而不是排版樣式;
  • 輕松的導出 HTML、PDF 和本身的 .md 文件;
  • 純文本內容,兼容所有的文本編輯器與字處理軟件;
  • 可讀,直觀。適合所有人的寫作語言。

教程

簡明教程:

詳細教程

博客園配置Markdown編輯器

  1. 進入博客后台
  2. 點擊“設置默認編輯器”
  3. 選中 Markdown並保存
  4. 回到隨筆界面點擊“添加隨筆”
  5. 在“Markdown編輯器”中輸入相應的代碼
    第一步
    第二步

語法

1. 標題

標題通過 # 的個數來進行區分,Mardown總共支持6級標題。
標題

2. 段落 & 換行

2.1. 首行縮進/空格:

  •  : 英文空格(半角)
  •  : 中文空格(全角)
  • 輸入法切換至全角,雙擊 空格 「推薦」
  • 半方大的空白  &#8194
  • 全方大的空白 &#8195
  • 不斷行的空白格  &#160

2.2. 強制換行

  連續的字符串,如果你想要換行,往往打“Enter”是不管用的,正確的換行方法為在 「在需要換行的地方插入 >=2 個 空格」

2.3. 空行

兩種方式:

  • 在markdown中加入 >=2 個空行.
  • 使用<br> 【推薦】
      
    mark

3. 列表

在Markdown下,有四種列表:有序和無序;

  • 有序列表:采用 1. 2. 3.的形式
  • 無序列表:采用前面加 * - + 的方式,支持多級嵌套
  • 未完成列表:- [ ],每個符號間均有空格
  • 已完成列表:- [x],注意空格使用
    PS: 符號與文字之間必須有 空格

mark
mark

4. 引用 (Quote)

若需要引入有出處的一段話等,可以采用引用的方式實現,實現方式為在行開始處加入>,如下所示:
mark

5. 字體設置

  • 粗體
    字符串前后均加上 **
  • 斜體
    字符串前后均加上 *
  • 刪除線
    字符串前后各加 ~~
  • ++下划線++
    字符串前后各加 ++
  • == 字體背景色 ==
    字符串前后各加 ==
  • 標記
    字體前后加上 ` (Esc下方的那個鍵)

mark

6. 分割帶

當上下文不屬於同一模塊或者無甚關聯時刻,可以使用分隔符進行隔開;分隔符的格式如下:

  • 連續多個-(>=3)
  • 連續多個*(>=3)
  • 連續多個下划線 _ (>=3)
  • PS:以上,分隔符中間可以有空格,但分割行不可有其它字符存在

mark

7. 圖片和鏈接

  • 圖片
    ![]() : [圖片名稱] (圖片網絡地址)
  • 鏈接
    []() : [鏈接名稱(可自定義)] (鏈接地址)

8. 代碼塊

和程序相關的寫作或是標簽語言原始碼通常會有已經排版好的代碼區塊,通常這些區塊我們並不希望它以一般段落文件的方式去排版,而是照原來的樣子顯示,Markdown 會用制表符來將代碼包起來。
代碼塊一直持續到沒有縮進的那一行(或是文件的結尾)

    #include <iostrem>  
    using namespace std;  
    int main(int argc, char **argv)  
    {
        cout << "hello,world!";
    }

9. 網址自動轉換

Markdown 支持以比較簡短的自動鏈接形式來處理網址和電子郵件信箱,只要是<>包起來, Markdown 就會自動把它轉成鏈接。一般網址的鏈接文字就和鏈接地址一樣,例如:

這個是我的博客地址:https://home.cnblogs.com/u/Jimmy1988/
我的郵箱地址是:JimmyNie2017@163.com

mark

10. 轉義

Markdown 可以利用反斜杠來插入一些在語法中有其它意義的符號,例如:如果你想要用星號加在文字旁邊的方式來做出強調效果,你可以在星號的前面加上反斜杠:

*literal asterisks*

Markdown 支持以下這些符號前面加上反斜杠來幫助插入普通的符號:

\ 反斜線
` 反引號
* 星號
_ 下划線
{} 花括號
[] 方括號
() 括弧
# 井字號
+ 加號
- 減號
. 英文句點
! 感嘆號

11. 生成目錄

  • 前提條件:

標題的建立是采用MD格式實現的,目錄的生成建議放在文本最開始部分(當然也可以嵌入在文中)。

  • 語法

[TOC],中間不要有空格

  • 注意事項

目錄的生成並不是每個編輯器都支持的,至今我用過的編輯器 有道雲筆記是支持的。

mark

12. 表格

mark
表格的做法通常為:

header 1 | header 2
--- |---
row 1 col 1 | row 1 col 2
row 2 col 1 | row 2 col 2

可用`<br>進行單元格內換行; 但是暫時不支持合並單元格


工具推薦

windows平台

Linux平台

Mac平台

瀏覽器插件

在線編輯器

  • 麻花:支持在線編輯,關鍵支持VIM命令

高級應用

更多工具


mark


免責聲明!

本站轉載的文章為個人學習借鑒使用,本站對版權不負任何法律責任。如果侵犯了您的隱私權益,請聯系本站郵箱yoyou2525@163.com刪除。



 
粵ICP備18138465號   © 2018-2025 CODEPRJ.COM