Markdown 语法学习

简介

Markdown 是一种轻量级标记语言,它用简洁的语法代替排版,使咱们专心于码字。它的目标是实现易读易写,成为一种适用于网络的书写语言。同时,Markdown支持嵌入html标签。html

注意:Markdown使用#、+、*等符号来标记,符号后面必须跟上至少1个空格才有效!java

Markdown的经常使用语法

标题

Markdown 标题支持两种形式:
一、用#标记:在标题开头加上1~6个#,依次表明一级标题、二级标题....六级标题git

# 一级标题
## 二级标题
### 三级标题
##### 四级标题
###### 五级标题
###### 六级标题

二、用=和-标记:在 标题底下加上任意个=表明一级标题,-表明二级标题(此方法适用于一级和二级标题)github

一级标题
======

二级标题
----------

效果以下:markdown

一级标题

二级标题

三级标题

四级标题

五级标题
六级标题

列表

Markdown 支持有序列表和无序列表。网络

**无序列表使用-、+和*做为列表标记:**测试

- Red
- Green
- Blue

* Red
* Green
* Blue

+ Red
+ Green
+ Blue

效果以下:网站

  • Red
  • Green
    • Blue
      • yellow
    • Black
      • pink

有序列表则使用数字加英文句点.来表示:url

1. Red
2. Green
3. Blue

效果以下:code

  1. Red
  2. Green
    1. Blue
      1. yellow
    2. Black
      1. pink

引用

引用以>来表示,引用中支持多级引用、标题、列表、代码块、分割线等常规语法。
常见的引用写法:

> 这是一段引用    //在`>`后面有 1 个空格
>  
>     这是引用的代码块形式    //在`>`后面有 5 个空格
>     
> 代码例子:
>    
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
    }
    
> 一级引用
> > 二级引用
> > > 三级引用

> #### 这是一个四级标题
> 
> 1. 这是第一行列表项
> 2. 这是第二行列表项

效果以下:

这是一段引用 //在>后面有 1 个空格

这是引用的代码块形式    //在`>`后面有 5 个空格

代码例子:

protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    setContentView(R.layout.activity_main);
}

一级引用

二级引用

三级引用

这是一个四级标题

  1. 这是第一行列表项
  2. 这是第二行列表项
    ***

强调

两个 * 或 - 表明加粗,一个 * 或 - 表明斜体,~~ 表明删除。

**加粗文本** 或者 __加粗文本__

*斜体文本*  或者_斜体文本_

~~删除文本~~

效果以下:

加粗文本 或者 加粗文本

斜体文本 或者 斜体文本

删除文本
***

图片与连接

图片与连接的语法很像,区别在一个 ! 号。
两者格式:

图片:![]()    ![图片文本(可忽略)](图片地址)

连接:[]()     [连接文本](连接地址)

连接又分为行内式、参考式和 自动连接:

这是行内式连接:[ConnorLin's Blog](http://connorlin.github.io)。

这是参考式连接:[ConnorLin's Blog][url],其中url为连接标记,可置于文中任意位置。

[url]: http://connorlin.github.io/ "ConnorLin's Blog"

连接标记格式为:[连接标记文本]:  连接地址  连接title(可忽略)

这是自动连接:直接使用`<>`括起来<http://connorlin.github.io>

这是图片:![][avatar]

[avatar]: https://connorlin.github.io/images/avatar.jpg

效果以下:

这是行内式连接:ntsclong Blog

这是参考式连接:ntsclong Blog,其中url为连接标记,可置于文中任意位置。

连接标记格式为:[连接标记文本]: 连接地址 连接title(可忽略)

这是自动连接:直接使用<>括起来http://www.ntsclong.com

这是图片:图片文本


视频插入

注:Markdown 语法是不支持直接插入视频的
广泛的作法是插入HTML的iframe标签,src能够经过网站自带的分享功能获取

将图片中的iframe标签添加进去
<iframe height=498 width=510 src='http://player.youku.com/embed/XMjgzNzM0NTYxNg==' frameborder=0 'allowfullscreen'>

第二是伪造播放界面,插入视频播放图片,点击时跳转到相关页面


代码

代码分为行内代码和代码块。

  • 行内代码使用`代码`标识,可嵌入文字中
  • 代码块使用4个空格或```标识

    ```
    这里是代码
    ```

  • 代码语法高亮在 ```后面加上空格和语言名称便可

    ``` 语言
    //注意语言前面有空格
    这里是代码
    ```

例如:

这是行内代码`onCreate(Bundle savedInstanceState)`的例子。

这是代码块和语法高亮:

``` java
// 注意java前面有空格
protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    setContentView(R.layout.activity_main);
}
```

效果以下:

这是行内代码onCreate(Bundle savedInstanceState)的例子。

这是代码块和语法高亮:

// 注意java前面有空格
protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    setContentView(R.layout.activity_main);
}

表格

表格对齐格式

  • 居左: :----
  • 居中: :----: 或 -----
  • 居右: ----:

例子:

|标题|标题|标题|
|:---|:---:|---:|
|居左测试文本|居中测试文本|居右测试文本|
|居左测试文本1|居中测试文本2|居右测试文本3|
|居左测试文本11|居中测试文本22|居右测试文本33|
|居左测试文本111|居中测试文本222|居右测试文本333|

效果以下:
|标题|标题|标题|
|:---|:---:|---:|
|居左测试文本|居中测试文本|居右测试文本|
|居左测试文本1|居中测试文本2|居右测试文本3|
|居左测试文本11|居中测试文本22|居右测试文本33|
|居左测试文本111|居中测试文本222|居右测试文本333|
***

分隔线

在一行中用三个以上的 * 、- 、_ 来创建一个分隔线,行内不能有其余东西。也能够在符号间插入空格。

***
---
___

* * *

效果均为一条分割线:
***
---

换行

在行尾添加两个空格加回车表示换行:

这是一行后面加两个空格  换行

效果以下:

这是一行后面加两个空格 换行

相关文章
相关标签/搜索