要么改变世界,要么适应世界

markdown的相关语法

2020-02-23 12:30:00
134
目录

前言

Markdown是一种可以使用普通文本编辑器编写的标记语言,通过简单的标记语法,它可以使普通文本内容具有一定的格式。

Markdown具有一系列衍生版本,用于扩展Markdown的功能(如表格、脚注、内嵌HTML等等),这些功能原初的Markdown尚不具备,它们能让Markdown转换成更多的格式,例如LaTeX,Docbook。Markdown增强版中比较有名的有Markdown Extra、MultiMarkdown、 Maruku等。这些衍生版本要么基于工具,如Pandoc;要么基于网站,如GitHub和Wikipedia,在语法上基本兼容,但在一些语法和渲染效果上有改动。

Markdown文件后期可以转换成html文件,所以在md文件中直接使用html语言也是可以的

语法介绍

1.标题(注意,许多地方一定不要忘了加空格)

标题的格式为 “#”+空格+标题名,其中“#”的个数代表这是几级标题,但是最多只能有6级标题

# 一级标题
### 三级标题
###### 六级标题
####### 这是一个错误的写法

上面的代码等效于

一级标题

三级标题

六级标题

####### 这是一个错误的写法


2.字体

  • 斜体:在欲显示斜体内容的两头加“*”
  • 加粗:在欲显示加粗内容的两头加“**”
  • 粗斜体:在欲显示粗斜体内容的两头加“***”
*这是斜体*
**这是粗体**
***这是粗斜体***

上面的代码等效于

这是斜体 这是粗体 这是粗斜体

  • 进阶使用

    指定字体:

    黑体字 我是华文彩云

    指定大小:

    <font size=20>大小=20</font>
    

    指定颜色:

    <font color=#ff0000>红色</font>
    

3.列表

  • 无序列表 “-”+空格+项目名

    - 项目一
    - 项目二
    
  • 有序列表 数字+“.”+空格+项目名

    1. 项目三
    2. 项目四
    

    上面代码等效于

    • 项目一
    • 项目二
    1. 项目三

    2. 项目四

4.表格

第一行是用“|”分开的表头 第二行是每一列的对齐方式,“:”在“-”的左边是左对齐,在右边是右对齐,没有“:”则默认是左对齐 第三行开始每一单元格用“|”分开

|上午|下午|晚上|
|:-|:-:|-:|
|写BUG(左对齐)|查BUG(居中对齐)|改BUG(右对齐)|
| 写BUG(左对齐) | 查BUG(居中对齐) | 改BUG(右对齐) |

上面的代码等价于

上午 下午 晚上
写BUG(左对齐) 查BUG(居中对齐) 改BUG(右对齐)
写BUG(左对齐) 查BUG(居中对齐) 改BUG(右对齐)

5.超链接

超链接的格式为:[描述]+(url)

[这是一个超链接](http://ruixin_huang.gitee.io/mblog/)

上面的代码等价于 这是一个超链接

6.图片

可以这样子引用

![这是一张网络图片](https://tse3-mm.cn.bing.net/th/id/OIP.UZQDK3pvdgKAoHoUVhyAhgHaDt?w=299&h=149&c=7&o=5&pid=1.7 "网络图片")

上面代码等效于 这是一张网络图片,随着时间流逝链接有可能失效 当然了,如果我们想要修改图片属性也是可以的,不过是要写成html格式的 如

<img src="https://tse3-mm.cn.bing.net/th/id/OIP.UZQDK3pvdgKAoHoUVhyAhgHaDt?w=299&h=149&c=7&o=5&pid=1.7 " width=500/>

上面的代码等价于 在hexo中,我们可以利用下面的方法显示本地图片

  1. 在博客根目录下的_config.yml文件中,把post_asset_folder属性改为true,这样子我们每次用new指令新建文章的时候,hexo就会自动在文章所在目录下生成一个与文章同名的文件夹,我们只需要在该文件夹下放置我们所需要显示的图片资源文件

  2. 在需要显示图片的地方输入以下代码

   {% asset_img 图片名加文件后缀 图片描述(可省) %}

{% asset_img 317325.jpg 这是一张本地图片文件 %}

7.代码块

代码的格式是用三个反引号将代码包起来,并且这三个反引号要分别独占一行 如:

(```)
printf("这是一段没有BUG的代码");
(```)

上面代码等效于

printf("这是一段没有BUG的代码");

8.分割线

用三个或者三个以上的“-”或者“*”都可以

---
***


历史评论
开始评论