會用 Markdown 還不夠，還得知道排版規範

時間 2019-11-08

標籤會用 markdown 不夠知道排版規範欄目 Markdown 简体版

原文原文鏈接

本文將會介紹 Markdown 中java

Markdown 標記的使用規範
使用空格、空行、縮進等元素優化排版的方法
經常使用中文標點符號規範

這些是 Markdown 寫做的比較常見的排版格式指導，同時也是排版格式約定。遵照它們能使得排版更加美觀，更加方便閱讀，也能讓你有固定的模式可依，下降寫做時對於排版的心智負擔。編程

Markdown 標記的使用規範

標題

文章的頂層標題使用二級標題（有時文章的標題並不須要寫在文章裏，好比大多數博客有專門的位置填寫文章標題，此時這級標題能夠省略）
每一個小節的標題使用三級標題
小節中進一步分層組織時使用四級標題
儘可能少用五級標題和六級標題，考慮用有序列表和無序列表代替
徹底不用一級標題

粗體、斜體

須要強調某處內容時使用粗體，如：網絡

中文全角標點符號佔一個漢字寬度，英文半角標點佔半個漢字寬度（亦即一個字母寬度）。工具

在中文排版中不使用斜體。在英文排版中可用斜體表達強調，或表示書名、題目。優化

引用塊

如下狀況使用引用塊：網站

引述內容時（也可直接用引號替代）
做示例時
給出提示、補充、警告等額外說明時

行內代碼

某一行文字中嵌入簡短代碼時使用行內代碼，如：spa

打開 Linux 虛擬終端，輸入 echo 'Hello World'。恭喜，你已經入門 Shell 了！code

代碼塊

展現多行代碼時使用代碼塊，也可用於 XML、JSON、配置項等。儘可能在使用代碼塊時給出語言標識，由於大多數 Markdown 工具會針對該語言高亮顯示其中的語言元素。如：cdn

```java public class Main { public static void main(String[] args) { System.out.println("Hello World"); } } ``` 將顯示爲：圖片
public class Main {
    public static void main(String[] args) {
        System.out.println("Hello World");
    }
}
複製代碼

圖片

Markdown 中使用 ![圖片名稱](https://xx.xx/xx) 的方式來插入圖片，這裏的「圖片名稱」能夠任取，可是推薦使用對圖片主題具備描述性的文字。由於在一些網站或軟件中，圖片沒法加載時會顯示這個「圖片名稱」，這時至少還能給讀者傳遞出一點有用信息。

轉義符號

若是不想讓 Markdown 標記生效，能夠在標記的每一個符號前加上反斜槓（\），這樣這些符號將按原樣顯示，再也不具備 Markdown 中的特殊意義。

如：

不想讓引用塊標記生效，可使用 \>，將顯示爲 >

不想讓二級標題標記生效，可使用 \#\#，將顯示爲 ##

空白符號的運用

空格

Markdown 中半角空格的使用很重要，一些狀況下能調節文字間距使得排版更加美觀。

中英文混排時，英文先後各加一個空格，如：

請堅信 Markdown 會爲你帶來生產力的提高。
中文和阿拉伯數字混排時，數字先後各加一個空格，如：

2008 年已通過去 11 年了！
若英文或阿拉伯數字緊鄰中文全角標點，則其與標點之間不加空格，如：

有了 Markdown，能夠再也不用 Word。
行內代碼的兩端各添加一個空格。若行內代碼緊鄰標點符號，則其與標點之間不加空格

打開 Linux 虛擬終端，輸入 echo 'Hello World'。

空行

正文段落之間用一個空行來分隔，能夠顯得段落分明、結構不擁擠，如：

Markdown 是一種標記語言。在寫做時，你的全部文字都是沒有樣式的純文本，在其中插入若干 Markdown 標記後，被標記的文字便有了樣式。

好比，在你所寫的文字中，但願某一行的最終排版呈現一級標題的樣式，那就給這行文字加個一級標題的標記；某個地方有兩個字須要加粗，那就給這兩個字加個粗體標記。