我的 MarkDown 學習筆記

来源:http://www.cnblogs.com/zhangyn/archive/2017/01/16/6290781.html
-Advertisement-
Play Games

MarkDown 一種用於寫作的輕量級【標記語言】。它用簡潔的語法代替排版,而不像一般的文字處理軟體 Word 或者 Pages 有大量的排版、字體設置等。 如果你對文章的樣式沒有太多要求,只註重寫文章本身的話 MarkDown 將會是一個不錯的選擇。 一、 工具 支持 MarkDown 寫作的軟體 ...


MarkDown 一種用於寫作的輕量級【標記語言】。它用簡潔的語法代替排版,而不像一般的文字處理軟體 Word 或者 Pages 有大量的排版、字體設置等。

如果你對文章的樣式沒有太多要求,只註重寫文章本身的話 MarkDown 將會是一個不錯的選擇。

一、工具

支持 MarkDown 寫作的軟體有很多,因為國外平臺的國內訪問大都不太穩,這裡就列舉幾個國內常用的:

  • 簡書 博客平臺,書寫的時候每隔幾秒鐘就會自動備份一次,需要註冊才能使用。

  • 馬克飛象 付費軟體,對於映像筆記用戶來說是個不錯的選擇。

  • Cmd MarkDown 作業部落的產品,跨平臺,支持 Windows、Linux、Mac 和 Web。而且提供了備份等功能。

  • Atom 著名的 Github 推出的編輯器,功能強大,支持原生實時預覽。實時預覽快捷鍵 ctrl+shift+m 。

二、基本語法

MarkDown 對於標題呀、字體呀等可能有多種寫法。個人建議初學的時候記憶一種語法就好,待熟練後若有興趣可多記幾種。

1.標題

MarkDown 支持 1~6 級標題,通過加在標題文字前的 # 來區分。例如,

# 這是一級標題
## 這是二級標題
...
###### 這是六級標題

Tips: # 和標題文字之間是有一個空格的。

2.段落

很簡單,一行文字就是一個段落。例如,

這是一行文字,MarkDown 中的段落。

如果要換行,那麼兩行之間要隔一個空行。例如,

這是一行文字,MarkDown 中的段落。
                               //這行是空行
這是另一行文字,MarkDown 中的段落。

3.粗體和斜體

Markdown 中字體的粗體和斜體用 ** * ** 表示。例如,

*這裡是斜體*
**這裡是粗體**
***這裡是粗體 + 斜體***

效果如下:

這裡是斜體

這裡是粗體

這裡是粗體 + 斜體

4.刪除線

可能有一部分編輯器不支持這個元素。刪除線用 ~ 定義。例如,

~~這裡有刪除線~~

效果如下:

這裡有刪除線

Tips: 刪除線要用兩個 ~ 來包裹文字。

5.引用

在一行文字前添加大於號 > 來使用引用格式。例如,

>這裡是引用句子。

效果如下:

這裡是引用句子。

引用可以嵌套使用,例如:

>>這裡使用了嵌套引用。

效果如下:

這裡使用了潛逃引用。

也可以嵌套其他格式。例如,

> ## 嵌套一個二級標題。
> *嵌套斜體字。*
> **嵌套粗體字。**

效果如下:

嵌套一個二級標題。

嵌套斜體字。

嵌套粗體字。

6.列表

列表分為無序列表和有序列表。

無序列表使用加號、減號和星號來標記。例如,

+ 加號列表
+ 加號列表
+ 加號列表

+ 減號列表
+ 減號列表
+ 減號列表

+ 星號列表
+ 星號列表
+ 星號列表

效果如下:

  • 加號列表
  • 加號列表
  • 加號列表

  • 減號列表
  • 減號列表
  • 減號列表

  • 星號列表
  • 星號列表
  • 星號列表

有序列表使用數字加上英文句點標記。

1.有序列表
2.有序列表
3.有序列表

7.內聯代碼

內聯代碼用反引號 ` 表示。例如,

`code`

有的地方說用單個 ` 即可表示內聯代碼,由於我用的是 Atom 編輯器,
單個 ` 不起作用,只好用兩個 ` 將代碼包裹起來。如果代碼中有反引號 ` ,
也可以兩個反引號將它包裹起來,但是要加空格。例如,

` ` `

效果如下:

code

`

8.代碼塊

有兩種風格,原生和 Github 。

原生風格,首行縮進四個空格。例如,

這是一個普通段落。

    這是一個代碼塊。

效果如下:

這是一個普通段落。

這是一個代碼塊。

Github 風格,代碼塊的前後用三個反引號獨占一行來標記。效果如下,

這裡是代碼塊。

9.分割線

分割線可以用三個以上的星號、減號或者底線來標識,行內不能有其他東西,但是可以插入空格。例如,

***

* * *

---

- - -

___

_ _ _

效果如下:







10.鏈接

鏈接用下麵的格式標識。例如,

[鏈接要顯示的文字](http://www.zhihu.com "滑鼠箭頭放到鏈接上的提示文字,可以不寫,與鏈接之間留有空格")

效果如下:

鏈接要顯示的文字

還可以用另外的格式標識,

[鏈接要顯示的文字][id]

在任意空白位置,

[id]:http://www.zhihu.com "滑鼠箭頭放到鏈接上的提示文字,可以不寫,與鏈接之間留有空格"

效果也是一樣的,

鏈接要顯示的文字

11.自動鏈接

如果鏈接的地址和要顯示的文字一樣的話,可以用尖括弧將其包裹形成自動連接。例如,

<http://www.zhihu.com>

效果如下:

http://www.zhihu.com

12.圖片

圖片的標識與鏈接類似。語法如下,

![圖片不存在時的提示文字](http://images.cnblogs.com/cnblogs_com/zhangyn/922022/o_%e6%89%8b.jpg "滑鼠箭頭放到圖片上的提示文字")

效果如下:

圖片不存在時的提示文字

[圖片不存在時的提示文字][imgid]
[imgid]:http://images.cnblog.com/cnblogs_com/zhangyn/922022/o_%e6%89%8b.jpg "滑鼠箭頭放到圖片上的提示文字"

圖片的 MarkDown 標識與 HTML 標簽有對應的關係,關係如下,

![img alt 屬性](img 地址 “img title 屬性”)

<img src='img 地址' alt='img alt 屬性' title='img title 屬性'>

13.轉義

支持在前面插入反斜杠轉義的字元如下,

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

效果如下:

\ 反斜線

` 反引號

* 星號

_ 底線

{} 花括弧

[] 方括弧

() 括弧

# 井字型大小

+ 加號

- 減號

. 英文句點

! 驚嘆號

14.表格

原本是 Github 風格的語法,大部分編輯器都支持。

| 鍵 | 值 | 備註 |
|----|----:|:------:|
|MacBookPro|¥12000|辦公用品|
|印表機|¥12000|辦公用品|
|台式電腦|¥12000|辦公用品|

效果如下:

備註
MacBookPro ¥12000 辦公用品
印表機 ¥1200 辦公用
台式電腦 ¥120

Tips:第一行表頭可以不要,第二行必須要有,第二行的冒號標識表中內容居左、居右還是劇中,如果不加冒號預設居左。

15.內嵌 HTML

MarkDown 保留了內嵌 HTML 的語法,標簽中的內容都會輸入到結果中。例如,

<html>
  <body>
    <iframe
      frameborder="no"
      border="0"
      marginwidth="0"
      marginheight="0"
      width=330
      height=86
      src="http://music.163.com/outchain/player?type=2&id=64447&auto=0&height=66">
    </iframe>
  </body>
</html>

效果如下:

竟然沒顯示出來zz....

16.目錄

只要按照 MarkDown 語法書寫,在需要生成目錄的地方寫[TOC] 就可以生成目錄了。

三、綜述

至此,就可以用 MarkDown 來寫一般的文章啦。當然,如果有特殊的需求,比如:輸入公式或者畫 UML 圖,那麼可以參考下麵的鏈接:

MarkDown Tex 公式輸入語法參考

MarkDown 時序圖語法參考

MarkDown 流程圖語法參考



您的分享是我們最大的動力!

-Advertisement-
Play Games
更多相關文章
  • jquery toggle([speed],[easing],[fn]) 用於綁定兩個或多個事件處理器函數,以響應被選元素的輪流的click事件 如果元素是可見的,切換為隱藏的;如果元素是隱藏的,切換為可見的。 例子: $("***").toggle( function(){ $(this).add ...
  • 第一種:函數直接執行模式 第二種:對象方法的調用模式 第三種:構造器的調用模式 第四種:call和apply調用模式 ...
  • 如果你是一個人在自學前端開發,或者是對前端開發有比較濃厚的興趣正想踏入前端領域,只要你在前端自學路上遇到了自己無法解決的技術難題,那麼儘管將你的疑惑交給我的小伙伴兒們吧,我們都是一群在前端自學路上摸爬滾打的有志青年,希望你可以來和我們共同交流。同時也希望你能獻出自己的一份力,幫助我的小伙伴兒們解決他 ...
  • 由[OpenDigg](http://www.opendigg.com/) 出品的前端開源項目周報第六期來啦。我們的前端開源周報集合了OpenDigg一周來新收錄的優質的前端開發方面的開源項目,方便前端開發人員便捷的找到自己需要的項目工具等。 ...
  • 模塊是 Node.js 應用程式的基本組成部分,文件和模塊是一一對應的。一個 Node.js 文件就是一個模塊,這個文件可能是 JavaScript 代碼、JSON 或者編譯過的 C/C++ 擴展。 由於JavaScript沒有模塊系統,所以Node.js依靠CommonJS規範自身實現了模塊系統。 ...
  • 實例 使用淡出效果來隱藏一個 <p> 元素: $(".btn1").click(function(){ $("p").fadeTo(1000,0.4); }); 親自試一試 實例 使用淡出效果來隱藏一個 <p> 元素: 親自試一試 定義和用法 fadeTo() 方法將被選元素的不透明度逐漸地改變為指 ...
  • 知識點: 1.UIButton使用和事件機制 2.UIImage 3.自定義UIButton UIButton 1.創建方式 按鈕類型 UIButtonTypeCustom 用戶自定義按鈕 UIButtonTypeRoundedRect 系統按鈕 UIButtonTypeDetailDisclosu ...
  • 從這裡開始是UI篇 知識點: 1.常用IOS基本控制項 2.UITouch 常用基本控制項 1.UISegmentedControl:分段控制器 1)創建方式 - (id)initWithItems:(NSArray *)items; items數組中可以有NSString或者是UIImage對象 UI ...
一周排行
    -Advertisement-
    Play Games
  • 移動開發(一):使用.NET MAUI開發第一個安卓APP 對於工作多年的C#程式員來說,近來想嘗試開發一款安卓APP,考慮了很久最終選擇使用.NET MAUI這個微軟官方的框架來嘗試體驗開發安卓APP,畢竟是使用Visual Studio開發工具,使用起來也比較的順手,結合微軟官方的教程進行了安卓 ...
  • 前言 QuestPDF 是一個開源 .NET 庫,用於生成 PDF 文檔。使用了C# Fluent API方式可簡化開發、減少錯誤並提高工作效率。利用它可以輕鬆生成 PDF 報告、發票、導出文件等。 項目介紹 QuestPDF 是一個革命性的開源 .NET 庫,它徹底改變了我們生成 PDF 文檔的方 ...
  • 項目地址 項目後端地址: https://github.com/ZyPLJ/ZYTteeHole 項目前端頁面地址: ZyPLJ/TreeHoleVue (github.com) https://github.com/ZyPLJ/TreeHoleVue 目前項目測試訪問地址: http://tree ...
  • 話不多說,直接開乾 一.下載 1.官方鏈接下載: https://www.microsoft.com/zh-cn/sql-server/sql-server-downloads 2.在下載目錄中找到下麵這個小的安裝包 SQL2022-SSEI-Dev.exe,運行開始下載SQL server; 二. ...
  • 前言 隨著物聯網(IoT)技術的迅猛發展,MQTT(消息隊列遙測傳輸)協議憑藉其輕量級和高效性,已成為眾多物聯網應用的首選通信標準。 MQTTnet 作為一個高性能的 .NET 開源庫,為 .NET 平臺上的 MQTT 客戶端與伺服器開發提供了強大的支持。 本文將全面介紹 MQTTnet 的核心功能 ...
  • Serilog支持多種接收器用於日誌存儲,增強器用於添加屬性,LogContext管理動態屬性,支持多種輸出格式包括純文本、JSON及ExpressionTemplate。還提供了自定義格式化選項,適用於不同需求。 ...
  • 目錄簡介獲取 HTML 文檔解析 HTML 文檔測試參考文章 簡介 動態內容網站使用 JavaScript 腳本動態檢索和渲染數據,爬取信息時需要模擬瀏覽器行為,否則獲取到的源碼基本是空的。 本文使用的爬取步驟如下: 使用 Selenium 獲取渲染後的 HTML 文檔 使用 HtmlAgility ...
  • 1.前言 什麼是熱更新 游戲或者軟體更新時,無需重新下載客戶端進行安裝,而是在應用程式啟動的情況下,在內部進行資源或者代碼更新 Unity目前常用熱更新解決方案 HybridCLR,Xlua,ILRuntime等 Unity目前常用資源管理解決方案 AssetBundles,Addressable, ...
  • 本文章主要是在C# ASP.NET Core Web API框架實現向手機發送驗證碼簡訊功能。這裡我選擇是一個互億無線簡訊驗證碼平臺,其實像阿裡雲,騰訊雲上面也可以。 首先我們先去 互億無線 https://www.ihuyi.com/api/sms.html 去註冊一個賬號 註冊完成賬號後,它會送 ...
  • 通過以下方式可以高效,並保證數據同步的可靠性 1.API設計 使用RESTful設計,確保API端點明確,並使用適當的HTTP方法(如POST用於創建,PUT用於更新)。 設計清晰的請求和響應模型,以確保客戶端能夠理解預期格式。 2.數據驗證 在伺服器端進行嚴格的數據驗證,確保接收到的數據符合預期格 ...