1. 程式人生 > >Readme.md常用語法總結

Readme.md常用語法總結

tab com 開頭 標題 ffffff 分享 了解 我們 添加

一、前言

當我們在GitHub上了解別人的項目的時候,一般都是先看Readme.md,既然這樣,如果我們想要讓別人了解我們的項目,就不能隨隨便便地寫Readme.md了。那Readme.md怎麽寫呢?Readme.md是有特定的語法規則的,稱之為Markdown語法,我這裏總結一些常用的語法,覺得有用就推薦一下吧。

二、語法

這裏我先推薦一個在線的Markdown編輯器:https://stackedit.io,可以用這個編輯器熟悉下語法。

1.標題

幾個“#”就表示幾級標題,註意最後一個“#”後面有一個空格

# h1 (一級標題)

## h2(二級標題)

### h3(三級標題)

2.文字格式

主要是粗體斜體的設置,用“*”和“_”都可以:

*斜體* (斜體)
**粗體** (粗體)
***粗斜體*** (粗斜體)

_斜體_ (斜體)
__粗體__ (粗體)
___粗斜體___ (粗斜體)

3.代碼

添加代碼:

`print("Hello World")`

還可以設置代碼塊高亮:

```        

print("Hello World")

```

4.引用

添加圖片:

![博客園](https://www.cnblogs.com/images/logo_small.gif)

添加鏈接:

[博客園](https://www.cnblogs.com)

5.符號

(1)換行符,註意在Readme.md中不是敲個Enter就換行了,而是在前一行的末尾加上兩個空格

技術分享圖片

技術分享圖片

(2)圓點符,一個“*”加一個空格就會變成一個圓點符:

技術分享圖片

技術分享圖片

(3)特殊符號:

技術分享圖片技術分享圖片

6.單行文本

用法就是在開頭加上兩個Tab,效果如下:

技術分享圖片

7.縮進

縮進好理解,用法就是在前面加“>”:

>數據結構
>>樹
>>>二叉樹

8.分割線

只需要三個或者三個以上的“*”、“-”或者“_”就會生成一條分割線:

***
---
___

9.刪除線

只需要在開頭和結尾加上兩個“~”,就會生成一條刪除線:

~~刪除線~~

10.數學公式

使用一對“$$”符號引用公式:

$\sqrt{x^{2}}$

Readme.md常用語法總結