MarkDown的使用教程

仿MarkDown使用教程

目錄

  • 前言
  • 簡介
  • MarkDown特點
  • 教程
  • 博客園配置MarkDown編輯器
  • 語法
      1. 標題
      1. 段落 & 換行
      1. 列表
      1. 引用(Quote)
      1. 字體設置
      1. 分隔帶
      1. 圖片和鏈接
      1. 代碼塊
      1. 網址自動轉換
      1. 轉義
      1. 生成目錄
      1. 表格
  • 工具推薦

前言

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

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

簡介

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

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

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

MarkDown特點

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

教程

   簡明教程

      - http://wowubuntu.com/markdown/basic.html

   詳細教程

      - http://wowubuntu.com/markdown/basic.html

博客園配置MarkDown編輯器

   1. 進入博客後臺

   2. 擊“設置默認編輯器”

   3. 選中 Markdown並保存

   4. 回到隨筆界面點擊“添加隨筆”

   5. 在“Markdown編輯器”中輸入相應的代碼

語法

1. 標題

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

2.段落&換行

2.1.首行縮進/空格

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

2.2.強制換行

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

2.3.空行

兩種方式:

  • 在markdown中加入 >=2個的空行
  • 使用 <br>[推薦]

3. 列表

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

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

         PS:符號與文字之間必須有 空格

    liebiao

4. 引用(Quote)

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

yinyong

5. 字體設置

  • 粗體

    字符串前後均加上**
  • 斜體

    字符串前後均加上*
  • 刪除線

    字符串前後各加~~
  • ++下劃線++

    字符串前後各加++
  • == 字體背景色 ==

    字符串前後各加==
  • 標記

    字體前後加上` (Esc下方的那個鍵)

zitishezhi

6. 分割帶

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

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

fengedai

7.圖片和鏈接

  • 圖片

    ![]()  :  [圖片名稱](圖片地址)
  • 鏈接

    []()  :  [鏈接名稱(可自定義)](鏈接地址)

在這裏插入圖片描述

8.代碼塊

和程序相關的寫作或是標籤語言原始碼通常會有已經排版好的代碼區塊,通常這些區塊我們並不希望它以一般段落文件的方式去排版,而是照原來的樣子顯示,MarkDown會用**製表符**來將代碼包起來。

代碼塊一直持續到沒有縮進的那一行(或是文件的結尾)

	<?php
	echo "hello world!";
	?>

9.網址自動轉換

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

這是百度地址:http:www.baidu.com

10.轉義

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

*litral asteriks*

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

\反斜線

`反引號

*星號

_下劃線

{}花括號

[]方括號

()括弧

#井字號

+加號

-減號

.英文句號

!感嘆號

11.生成目錄

  • 前提條件:

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

  • 語法:

    ``,中間不要有空格

  • 注意事項:

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

12.表格

表格的做法通常爲:

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命令

高級應用

更多工具

發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章