簡單 Markdown 語法照著寫一遍

qianyewoailuo發表於2019-04-16

現在開始學習一下MarkDown的書寫格式吧

使用社群 Markdown 編輯器撰寫技術文章,只專注於內容和技術,不再費心排版的問題。這是一份簡要的 Markdown 引導指南,希望可以幫助您順利的開始使用 Markdown 編輯器。

基礎語法

1. 標題

標題的語法格式為 # + 空格 + 文字,例如

二級標題

三級標題

四級標題

五級標題

的書寫方式為

# 一級標題
## 二級標題 
### 三級標題 
#### 四級標題
##### 五級標題

額外的可以使用 --------*************等多個作為分割線,例如


2. 列表

在MarkDown中,無序列表只要在文字前面加上-即可,例如

  • 無序列表1
  • 無序列表2
  • 無序列表3

的書寫方式就是

- 無序列表1
- 無序列表2
- 無序列表3

而有序列表則在文字前面加上相關序號 1.,例如

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

的書寫方式就是

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

3. 連結與圖片

在MarkDown中插入連結需要使用[連結文字](連結地址)的格式語法,例如

這是一個百度連結

的書寫方式為

[這是一個百度連結](https://www.baidu.com/)

至於圖片插入的語法格式其實和連結十分相像,只是在前面多一個!號,例如

插入一張圖片

的書寫方式為

![插入一張圖片](https://i.iter01.com/images/bcab0c8829296242a9a897c2c81601d2aa9f7012ee0cf17d7fefd025fce0fab8.jpg)

4. 引用

寫作時會經常引用他人的文字,這時候在MarkDown中你只要在引用的文字前面加上>即可,例如

Markdown 是一種輕量級標記語言,它允許人們使用易讀易寫的純文字格式編寫文件,然後轉換成格式豐富的 HTML 頁面

的書寫方式為

> Markdown 是一種輕量級標記語言,它允許人們使用易讀易寫的純文字格式編寫文件,然後轉換成格式豐富的 HTML 頁面

5. 行內引用與程式碼高亮

行內的程式碼可以使用 ` 包起來即可,一般在描述類、函式、檔名稱及路徑時使用,例如下面這段話:

Laravel 框架的所有配置檔案都儲存在 config 目錄中。可以使用 config() 輔助函式來讀取。

的書寫方式為

> Laravel 框架的所有配置檔案都儲存在 `config` 目錄中。可以使用 `config()` 輔助函式來讀取。

程式碼段或程式碼高亮則至少使用3個```頭尾包裹程式碼區塊,例如

<?php
echo 'hello world';
?>

的書寫方式為

   ( ```)
    <?php
    echo 'hello world';
    ?>
    (```) 不用寫括號的

注意!!!在第一個包裹的 ``` 的後面加上相應的程式語言名稱可以顯示相應語言具體的高亮的程式碼

6. 粗體與斜體

Markdown 的粗體和斜體非常簡單,用 ** 包含一段文字就是粗體的語法,用一個 * 包含一段文字就是斜體的語法。例如:

MarkDown 的 粗體斜體 寫法十分簡單

的書寫方式為

> MarkDown 的 **粗體** 與 *斜體* 寫法十分簡單

7. 表格

基礎的表格構建使用 | 分割表格 -----區分表頭,例如

姓名 性別 船內分工
路飛 船長
娜美 航海士
索隆 劍士
羅賓 考古學家

的書寫方式為

姓名 | 性別 | 船內分工 
--------  |  --- | ---
路飛 | 男 | 船長
娜美 | 女 | 航海士
索隆 | 男 | 劍士
羅賓 | 女 | 考古學家

一個好看的表格還應該考慮對齊方式的設定,在MarkDown中使用:就能定義各種對齊方式,例如

專案 價格 預估耗時
部落格 888 1周以內
微信小程式 1888 2~3周
線上教育 5888 4~5周
商城系統 8888 至少7周

的書寫方式為

專案 | 價格 | 預估耗時
:----- | ----: | :---:
部落格 | 888 | 1周以內 
微信小程式 | 1888 | 2~3周
線上教育 | 5888 | 4~5周
商城系統 | 8888 | 至少7周

結語

至此簡單的Markdown語法格式已經羅列完畢

在掌握的以上的簡單基礎語法後,推薦進一步查閱MarkDown的完整語法

本作品採用《CC 協議》,轉載必須註明作者和本文連結