天天看點

markdown java 代碼高亮_Markdown 代碼塊與文法高亮

文法說明:

插入程式代碼的方式有兩種:使用反引号 `(~ 鍵)、使用縮進(Tab)。

插入行内代碼,即插入一個單詞或者一句代碼的情況,使用 `code` 這樣的形式插入。

插入多行代碼,分别使用三個反引号(```)包裹多行代碼。或者使用縮進。

行内代碼

在一般的段落文字中,可以使用反引号 ` 來标記或插入代碼區段。

C語言裡的函數 `scanf()` 怎麼使用?

C語言裡的函數 scanf() 怎麼使用?

當然也可以标記 檔案名 、關鍵詞 等。

多行代碼

在需要高亮的代碼塊的前一行及後一行使用三個反引号 ```(~ 鍵)

同時第一行反引号後面,輸入代碼塊所使用的語言,實作代碼高亮。

比如高亮 python3 代碼塊:

```python

#!/usr/bin/env python3

print("Hello, World!");

```

顯示為:

#!/usr/bin/env python3

print("Hello, World!");

縮進式插入多行代碼

注意:

縮進式插入前方必須有空行;

縮進 4 個空格或是 1 個制表符;

一個代碼區塊會一直持續到沒有縮進的那一行(或是檔案結尾)。

代碼:

此處有空行

#include `

int main(void)`

{

printf("Hello world\n");

}

顯示效果:

#include `

int main(void)`

{

printf("Hello world\n");

}

代碼區塊中的内容

代碼區塊中,一般的 Markdown 文法不會被轉換,像是 * 便隻是星号,這表示你可以很容易地以 Markdown 文法撰寫 Markdown 文法相關的檔案。

```markdown

Markdown 文法展示

```

比如下面展示 Markdown 常用文法:

Markdown 目錄:

[TOC]

Markdown 标題:

# 這是 H1

## 這是 H2

### 這是 H3

Markdown 清單:

- 清單項目

1. 清單項目

*斜體*或_斜體_

**粗體**

***加粗斜體***

~~删除線~~

Markdown 插傳入連結接:

[連結文字](連結網址 "标題")

Markdown 插入圖檔:

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

Markdown 插入代碼塊:

```python

#!/usr/bin/python3

print("Hello, World!");

```

Markdown 引用:

> 引用内容

Markdown 分割線:

---

Markdown 換行:

Markdown 段首縮進:

  or   表示一個半角的空格

  or   表示一個全角的空格

   兩個全角的空格(用的比較多)

  or   不斷行的空白格

通路簡書專題:我的筆記,檢視更多内容。

光懂文法還不能寫出排版優秀的文章,我們還需要學習 Markdown 編寫規範,讓我們的文章看起來很專業。已經有好人寫了文章:

少數派 的文章排版比較規範,大家可以多逛逛。

學會了排版,要寫出一篇優秀的文章,我們還要在内容管理上下功夫,最基本的素養就是不要傳遞錯誤的資訊,其次是關注所傳遞内容的價值大小。這時候,我們不僅要有相關專業知識(有理有據),還要想文章的架構結構,要考慮讀者的感受等。平時看熱門文章和暢銷圖書時,多留意它們的排版和文章結構,都可以學習借用。這裡隻是抛磚引玉,詳細技巧可以知乎一下。

參考文章