Markdown 基本語法

来源:http://www.cnblogs.com/zfc2201/archive/2017/06/15/7021162.html
-Advertisement-
Play Games

段落 非常自然,一行文字就是一個段落。 比如 這是一個段落。 會被解釋成 這是一個段落。 如果你需要另起一段,請在兩個段落之間隔一個空行。 這是一個段落。 這是另一個段落。 會解釋成 這是一個段落 這是另一個段落 不隔一個空行的換行行為,在一些編輯器中被解釋為換行,即插入一個標簽。對與另外一些編輯器 ...


段落

非常自然,一行文字就是一個段落。

比如

這是一個段落。

會被解釋成

<p>這是一個段落。</p>

如果你需要另起一段,請在兩個段落之間隔一個空行。

這是一個段落。

這是另一個段落。

會解釋成

<p>這是一個段落<p>
<p>這是另一個段落</p>

不隔一個空行的換行行為,在一些編輯器中被解釋為換行,即插入一個
標簽。對與另外一些編輯器,會被解釋為插入一個空格。對於後者,若要插入換行標簽,請在當前一行的結尾打兩個空格。

粗體、斜體

可以使用星號*或下劃線_指定粗體或者斜體。

*這是斜體*
_這也是斜體_
**這是粗體**
***這是粗體+斜體***

會被解釋成

<em>這是斜體</em>
<em>這也是斜體</em>
<strong>這是粗體</strong>
<strong><em>這是粗體+斜體</strong></em>

刪除線

一部分編輯器支持刪除線,它不是經典markdown中的要素。用波浪線~定義刪除線。

~~就像這樣~~

會被解釋成

<strike>就像這樣</strike>

標題

markdown總支持1~6六級標題,通過在一行之前加上不同數量的井號來表示。

# 這是 H1 #

## 這是 H2 ##

### 這是 H3 ###

...

###### 這是 H6 ######

行尾可以加上任意數量的井號字元,這些字元不會算作標題內容。通常會加上相等數量的字元以保持對稱。

此外,H1和H2也可以採用在文本下方添加底線來實現,比如:

這是 H1
=======

這是 H2
-------

引用

通過在行首加上大於號>來添加引用格式。

> This is a blockquote with two paragraphs. Lorem ipsum dolor sit amet,
consectetuer adipiscing elit. Aliquam hendrerit mi posuere lectus.
Vestibulum enim wisi, viverra nec, fringilla in, laoreet vitae, risus.

> Donec sit amet nisl. Aliquam semper ipsum sit amet velit. Suspendisse
id sem consectetuer libero luctus adipiscing.

引用可以嵌套:

> This is the first level of quoting.
>
> > This is nested blockquote.
>
> Back to the first level.

也可以嵌套其他格式:

> ## 這是一個標題。
>
> 1.   這是第一行列表項。
> 2.   這是第二行列表項。
>
> 給出一些例子代碼:
>
>     return shell_exec("echo $input | $markdown_script");

列表

無序列表使用星號、加號或是減號作為列表標記:

*   Red
*   Green
*   Blue

等同於

+   Red
+   Green
+   Blue

-   Red
-   Green
-   Blue

有序列表則使用數字接著一個英文句點:

1.  Bird
2.  McHale
3.  Parish

數字並不會影響輸出的 HTML 結果,也就是說上面的例子等同於:

1.  Bird
1.  McHale
1.  Parish

內聯代碼

用反引號 ` 來標記內聯代碼,它們會解釋成<code>標簽。如果代碼的內容中有反引號,請用兩個反引號包裹。代碼中的&<>符號都會自動轉義,請放心使用。

代碼區域

有兩種方式標記代碼區域,原生風格是行首縮進四個空格。

這是一個普通段落:

    這是一個代碼區塊。

會被解釋成

<p>這是一個普通段落:</p>

<pre><code>這是一個代碼區塊。
</code></pre>

除了行首的4個空格會被移出,其它不變。像內聯代碼一樣,上述三種符號也會被轉義。但在代碼段中,星號之類的markdown標記符號則不會解析。

還有一種是github的風格,代碼段的前後用三個反引號獨占一行來標記。

```
這是一個代碼區塊
```

目前主流編輯器都支持這種風格。

分隔線

你可以在一行中用三個以上的星號、減號、底線來建立一個分隔線,行內不能有其他東西。你也可以在星號或是減號中間插入空格。下麵每種寫法都可以建立分隔線:

* * *
***
*****
- - -
---------------------------------------

鏈接

[an example](http://example.com/)
[an example](http://example.com/ "Optional Title")

會被解釋為

<a href='http://example.com/'>an example</a>
<a href='http://example.com/' title="Optional Title">an example</a>

除了上面的行內式,也可以使用參考式:

[an example][id]

然後在任意空白位置定義:

[id]: http://example.com/ "Optional Title"

圖像

![Alt text](/path/to/img.jpg)
![Alt text](/path/to/img.jpg "Optional Title")

會被解釋為

<img src='/path/to/img.jpg' alt='Alt text' />
<img src='/path/to/img.jpg' alt='Alt text' title='Optional Title' />

同樣,圖像也有類似的參考式語法。

自動鏈接

如果鏈接的地址和名字重覆,可以用尖括弧語法將其簡化。

<http://example.com/>

就相當於

[http://example.com/](http://example.com/)

切記,大多數編輯器都會自動將符合url規則的東西視為鏈接,並且解釋成鏈接。很多時候作者由於疏忽等緣故,鏈接和後面的中文之間缺少空格,導致鏈接不正常。所以我建議,鏈接要麼加上尖括弧,要麼兩端加上空格。

轉義

markdown支持在以下字元前面插入反斜杠

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

插入之後,將不再解析這些字元,而是原樣輸出。

表格

表格是github風格獨有的語法,但近年來漸漸被大多數編輯器支持。

| Item     | Value | Qty   |
| :------- | ----: | :---: |
| Computer | $1600 |  5    |
| Phone    | $12   |  12   |
| Pipe     | $1    |  234  |

會被解釋成

<table>
<thead>
<tr>
<th align="left">Item</th>
<th align="right">Value</th>
<th align="center">Qty</th>
</tr>
</thead>
<tbody><tr>
<td align="left">Computer</td>
<td align="right">$1600</td>
<td align="center">5</td>
</tr>
<tr>
<td align="left">Phone</td>
<td align="right">$12</td>
<td align="center">12</td>
</tr>
<tr>
<td align="left">Pipe</td>
<td align="right">$1</td>
<td align="center">234</td>
</tr>
</tbody></table>

要註意第二行的冒號決定了居左居右還是居中,如果你不加冒號,預設是居左的。

另外可以把第一行去掉,做成沒有表頭的表格,但第二行始終是要有的。

內聯 HTML

markdown 的語法簡潔,但有其局限性,所以特意保留了內聯html這種方式。任何html標簽及其內容,都會原樣輸出到結果中。也就是說,標簽中的星號等作為markdown結構的符號,以及構成html標簽和實體的符號,都不會做任何轉義。


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

-Advertisement-
Play Games
更多相關文章
  • 前言: 這幾天剛剛開始學習python,然後就安裝了pycharm,但是那個中文亂碼的問題真是讓人心煩,在網上找了好久,都寫得好亂,今天終於讓我解決了,在這裡總結一下經驗,希望可以幫到你們 問題:如下圖,我的問題主要是在控制台輸入漢字的時候會出現以下亂碼 一般的解決方法 1. 首先如上圖所示,把fi ...
  • Java 數據類型 基本數據類型 數值:int、short、long 字元:char 布爾:boolean 引用數據類型 class(類) interface(介面) 數組[] 所占位元組數 ( ) int:4位元組 char: 規定2位元組。若使用UTF 8編碼,數字和英文等占1個位元組,中文3個位元組;若 ...
  • 目錄 自定義函數 內置函數 文件的操作 練習題 一. 自定義函數 1. 函數的創建 2. 函數的參數 (1)參數的定義 參數是使用通用變數來建立函數和變數之間關係的一個變數。我們都知道函數是用來被調用的,當我們需要給這個函數傳送值的時候,參數用來接收調用者傳遞過來的數據,並保存下來作為一個變數以便後 ...
  • re模塊 序言: re模塊用於對python的正則表達式的操作 標誌位即模式修正符,不改變正則表達式的情況下,通過模式修正符改變正則表達式的含義,從而實現一些匹配結果的調整等功能: 貪婪模式、懶惰模式: match: 從起始位置開始根據模型去字元串中匹配指定內容: 匹配ip地址: search: 根 ...
  • 1. 為重用以及更好的維護代碼,`Python`使用了模塊與包;一個`Python`文件就是一個模塊,包是組織模塊的特殊目錄(包含`__init__.py`文件)。 2. 模塊搜索路徑,`Python`解釋器在特定的目錄中搜索模塊,運行時`sys.path`即搜索路徑。 3. 使用`import`關... ...
  • 編譯器是怎麼實現引用類型的呢?本篇文章複習了const常量和指針,在此基礎上推測了引用類型的本質。旨在加深對語言的理解,希望對你有所幫助。 ...
  • /* 這裡要說明一下 因為本人比較懶 博客中相關文章的內容更多的是對一書中代碼的整理和簡單註解方便自己日後複習和參考, 對相關內容感興趣的初學的朋友建議請先閱讀原文。此處的內容只能當成一種學習的補充和參考。謝謝! 因原書中領域模型+數據映射器的示例代碼是連貫在一起的 所以這裡就整理在一起了。 簡單介... ...
  • jdk1.7.0_79 對於線程池大部分人可能會用,也知道為什麼用。無非就是任務需要非同步執行,再者就是線程需要統一管理起來。對於從線程池中獲取線程,大部分人可能只知道,我現在需要一個線程來執行一個任務,那我就把任務丟到線程池裡,線程池裡有空閑的線程就執行,沒有空閑的線程就等待。實際上對於線程池的執行 ...
一周排行
    -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.數據驗證 在伺服器端進行嚴格的數據驗證,確保接收到的數據符合預期格 ...