Markdown语法规范(修订)

lemooljiang(76)
Published in
#cn
Words
1045
Reading
5 min
Listen
Play
7y

markdown.jpg

Markdown

目录


简介

Markdown 轻量化的标记语言,一种适用于网络的书写语言。Markdown 是一个面向写作的语法引擎,Markdown 的最终目的都是解析成 HTML 用于网页浏览,所以它兼容 HTML 语法,即你可以在 Markdown 文档中使用原生的 HTML 标签。

本文分三部分:基础语法,高级点的语法和好用的HTML标签。

一、基础语法

1.标题设置

在文字开头加上 “#”,后接一个空格。通过“#”数量表示几级标题。(一共只有1~6级标题,1级标题字体最大),如下:
注意:后要加空格

# 一级标题
## 二级标题
### 三级标题

2.首行缩进

中文在排版时首行都有缩进两格,或是编辑时要有多个空格。

实现方法:

  1. 编辑器中要在全角状态下才能输入空格!在中文输入法时用shift+空格键切换成全角,再输入两个空格。
  2. 使用HTML空格标签:  ,直接在行首加入 ,需要几个加几个。

3.引用文字

在句首加上">"即可。格式如下:> 引用文字,结束时换行。如下:

>这是毛主席说的,枪杆子里出政权。

4.斜体和粗体文字

将需要设置为斜体的文字两端加或是_ ;粗体的文字两端加*或__,(注意:文字两端不能有空格),如下:

**
****
__
____

5.分割线

****

6.删除线

~~删除线~~

7.无序列表

在文字开头添加(, +, 或 -)实现无序列表。注意在(, +, 或 -)和文字之间需要添加空格。如下:

* 
* 

8.有序列表

使用数字后面跟上点号.(还要有空格)如下:

1. 
2. 

9.链接(Links)

Markdown中有两种方式实现链接,行内式链接和参考式链接

  1. 行内式链接:[文章名](文章url)。例如:
    [新人生存指南之一:steem介绍](https://steemit.com/steemit/@lemooljiang/3f5j36-steem)

  2. 参考式链接,例如:

markdownoflyhigh[使Markdown][1] lemoojiang[][2]  carinewhy[-steemit][3]
...
[1]: https://steemit.com/cn/@oflyhigh/markdown
[2]: https://steemit.com/cn/@lemooljiang/4mddsq 
[3]: https://steemit.com/cn-tutorial/@carinewhy/625apt-steemit

10.图片(Images)

图片的处理方式和链接的处理方式,非常地类似(前面加!),有行内式链接和参考式链接。

  1. 行内式链接:![图片名称](图片url),例如:
    ![sea](https://steemitimages.com/DQmS5CXgThWGHKzmzU5ombr87dWXzvPXpVsTBowkNKjtWuU/sea.jpg)
  1. 参考式链接:
![1][id1] 
![2][id2]
...
[id1]:url
[id2]:url

11.视频(videos)

利用视频服务器的插入代码,例如:

<iframe width="560" height="315" src="https://www.youtube.com/embed/1eTj_TGJMvw" frameborder="0" allowfullscreen></iframe>

12.表格

下面的例子是设计三列的表格,要几列,就用几个“|”分隔。

||        
------------|------------|------------ 
1||
2||   

效果如下:

序号内容作者
1天龙八部金庸
2绝代双娇古龙

13.页内锚点

<a href="#2"></a>
......
<a id="2">2</a> 

14.使用目录

1
## 目录
  * [](#一、基础语法)
     1. [](#1.标题设置)
     2. [serializer](dates/serializer.md))
  * [](#二、高级点的语法)
     1. [](##2.反斜杠)
     2. [](###14.目录)

2使Markdown TOC
 2.1 VScode Markdown TOC
 2.2 Markdown TOC:Insert/Update
 2.3 TOCsettings -> Eol -> auto \n 
 2.4  # 的文字 ,还有无法获取长文件的目录。

二、高级点的语法

1.代码区块(HTML中所谓的Code)

a. 
使 ` 括起来。(左上角的ESC下面~中的`
b. 
使 ` 括起来 ,如下:
```  ```

2.反斜杠

Markdown 可以利用反斜杠来插入一些在语法中有其它意义的符号,例如:如果你想要用星号加在文字旁边的方式来做出强调效果,如下:

\*这是需要强调的部分\*

三、好用的HTML标签

1.文字居中

用HTML的一对标签来实现,就是<center>。格式如下:

<center><h2>这是标题(文字)</h2> </center>

2.分栏排版

段落分成两列或是三列排版,可以用<div><table>标签来实现。
两栏的版式:

第一种:
<div class="pull-left">这是文字部分1</div>这是文字部分2
注:steemit上支持这种写法的。

或者使用 style 来控制:
<div style="width:50%; float:left; margin-right:12px">这是文字部分1</div>这是文字部分2

第二种:

<table>
  <tr>
    <td>1</td>
    <td>2</td>
  </tr>
</table> 

三栏的版式

<table>
  <tr>
    <td>1</td>
    <td>2</td>
    <td>3</td>
  </tr>
</table>

注:以上样式中都可以加上 style 属性来加强控制,但各个网站对 style 属性的支持度是不一样的(steemit,github都不支持),请自行调试后使用。

3.图文混排

第一种:使用div
<div class="pull-left"><img src="https://cn.bing.com/tt.jpg"</div>这是文字部分
注:steemit上支持这种写法。

第二种:给 img 加上style属性:
<img src="https://cn.bing.com/tt.jpg" style="width:200px; float:left; margin-right:12px">这是文字部分

4.其它支持的标签

1<h1></h1>
2<br/> 
3<hr/>线
4<b></b>
5<del></del>
6<code><div></code>
7<strong></strong>
8<em></em>
9<i></i>
10<blockquote></blockquote>
11<sub></sub>
12<a href="www.baidu.com"></a>

lemooljiang@lemooljiang 2019.10.15

Markdown语法规范(修订) | Ecency