阅读 289

mackdown语法

  • mackdown-说明

兼容 HTML

Markdown 不是想要取代 HTML,甚至也没有要和它相近,它的语法种类很少,只对应 HTML 标记的一小部分。 Markdown 的构想不是要使得 HTML 文档更容易书写,不在 Markdown 涵盖范围之内的标签,都可以直接在文档里面用 HTML 撰写。 不需要额外标注这是 HTML 或是 Markdown;只要直接加标签就可以了。 要制约的只有一些 HTML 区块元素――比如 <div>、<table>、<pre>、<p> 等标签,必须在前后加上空行与其它内容区隔开,还要求它们的开始标签与结尾标签不能用制表符或空格来缩进

  1. mackdown-说明
    1. mackdown-段落与换行
    2. mackdown-标题语法
    3. mackdown-斜体,粗体,删除线语法
    4. mackdown-Blockquotes引用
    5. mackdown-列表
    6. mackdown-代码块
    7. mackdown-行内代码
    8. mackdown-分隔线
    9. mackdown-反斜杠转义
    10. mackdown-自动链接
    11. mackdown-链接
    12. mackdown-图片
    13. mackdown-背景色
    14. mackdown-表格
    15. mackdown-锚点
    16. 其他
  • mackdown-段落与换行

Mackdown的段落由一个或多个 连续 的文本行组成,它的前后要有 一个以上 的空行,普通段落不该用 空格或制表符 来缩进,所以如果要强制Mackdown语法换行可以在段落中插入换行符 <br/> 或者键入两个以上的 空格或者制表符,然后按 回车键 即可

  • mackdown-标题语法

Markdown 支持两种标题的语法,类 Setext 和类 atx 形式。

atx 类型:标题采用 # 开头,跟据 # 个数依次表示 h1~h6
Setext 类型:利用 =(最高阶标题)和 - (第二阶标题),任意数量

### atx语法
# h1
## h2
### h3
#### h4
##### h5
###### h6

...... 闭合语法.......
# h1 #
## h2 ##
### h3 ###
#### h4 ####
##### h5 #####
###### h6 ######
复制代码

H1

H2

H3

H4

### Setext语法

H1
=============

H2
-------------
复制代码

H1

H2

  • mackdown-斜体,粗体,删除线语法

斜体:采用 * 包裹需要使用斜体的对象

粗体:采用两个 * 包裹需要使用粗体的对象

倾斜加粗:采用三个 * 包裹需要使用倾斜加粗的对象

删除线:采用两个 ~ 包裹需要使用删除线的对象

*我是斜体*

**我是粗体**

***倾斜加粗***

~~删除线~~
复制代码

我是斜体

我是粗体

倾斜加粗

删除线

  • mackdown-Blockquotes引用

区块引用是使用类似 email 中用 > 的引用方式,在引用前面使用 一个以上> 来表示,如果需要换行显示,则可以中间放置一个空的 > 来隔离,同样如果是嵌套的语法想返回上一层,可以加入一个空的同级引用来跳出

>莎士比亚说:好好学习mackdown。
复制代码
>莎士比亚说:好好学习mackdown。
>
>我说:好好学习mackdown,才能写好博客
>>这是嵌套引用
>>
>返回上一层
复制代码
### blockquotes语法中同样可
### 以嵌套其他类型的mackdown语法
Eg:
    > `echo 'hello mackdown!!!'`

复制代码

莎士比亚说:好好学习mackdown。

莎士比亚说:好好学习mackdown。

我说:好好学习mackdown,才能写好博客

这是嵌套引用

返回上一层

echo 'hello mackdown!!!'

  • mackdown-列表

列表分为有序列表,无序列表两类 ,也可混合使用

无序列表:采用 - , + , * 表示

有序列表:采用 1., 2. 数字加英文 . 表示

 * 一级1
    * 二级1
        * 三级1
        * 三级2
    * 二级2
复制代码
  • 一级1
    • 二级1
      • 三级1
      • 三级2
    • 二级2
1. 一级1
    1. 二级1
        1. 三级1
        2. 三级2
    2. 二级2
    
(混合使用)

* 1. 一级1
    * 1. 二级1
        * 1. 三级1
        * 2. 三级2
    * 2. 二级2
复制代码
  1. 一级1
    1. 二级1
      1. 三级1
      2. 三级2
    2. 二级2

    1. 一级1
      1. 二级1
        1. 三级1
        1. 三级2
      1. 二级2

你在列表标记上使用的数字并 不会影响 输出的 HTML 结果,如下两种写法都只会生成一种结果,不过,建议使用规范的排序,更好的支持有序列表的start属性

1. one
2. tow
3. three

5. one
4. tow
8. three
复制代码
<ol>
    <li>one</li>
    <li>two</li>
    <li>three</li>
</ol>
复制代码

如果列表项目间用空行分开,在输出 HTML 时 Markdown 就会将项目内容用 p 标签包起来

1. one

2. tow
复制代码
<ol>
    <li><p>one</p></li>
    <li><p>two</p></li>
</ol>
复制代码

如果列表项目间混杂了带有 . 的语句,可以使用 \ 转义如下:

2019. hello world!!
复制代码
2019\. hello world!!
复制代码
  • mackdown-代码块

在mackdown中使用代码块有三种方式

使用 ```语法;

使用 <pre> 标签;

使用4个空格或是 1 个制表符

    我是一个代码块
复制代码
  • mackdown-行内代码

使用两个` 包裹表示行内代码

    `echo "Hello World!!"`
复制代码

echo "Hello World!!"

  • mackdown-分隔线

使用三个以上的星号、减号、底线来建立一个分隔线

****
* * *
_____
-----
复制代码




  • mackdown-反斜杠转义

Markdown 可以利用反斜杠来插入一些在语法中有其它意义的符号

\*我转义了\*
复制代码

*我转义了*

Markdown支持的转义类型包含如下:

\   反斜线
`   反引号
*   星号
_   底线
{}  花括号
[]  方括号
()  括弧
#   井字号
+   加号
-   减号
.   英文句点
!   惊叹号
复制代码
  • mackdown-自动链接

mackdown支持 <> 包裹url或者email地址的的方式来表示自动连接,Markdown 会自动把它转成 <a href="url">url</a> 形式的链接


<http://www.baidu.com/>
复制代码

www.baidu.com/

  • mackdown-链接

Markdown 支持两种形式的链接语法

行内式: 在 [] 后面紧接着()并插入网址链接,页面显示的文字放在 []内, 链接的 title 文字是()内的第二个参数

参考式:在第二个 []中插入一个唯一值, 然后定义可以放在文件中的任何一个地方

###行内式

这是 [百度](http://baidu.com/ "百度") 的链接.

复制代码

这是 百度 的链接.

###参考式

这是 [百度][id] 的链接.

[id]: http://baidu.com/ "百度"
复制代码

这是 百度 的链接.

  • mackdown-图片

图片的语法是在链接的语法上衍生的,同样分为行内式跟参考式

行内式: 在 ![] 后面紧接着()并插入图片链接地址,图片的alt属性放在 []内, 图片的 title 文字是()内的第二个参数

参考式: 在第二个 []中插入一个唯一值, 然后定义可以放在文件中的任何一个地方


![Alt text](/path/to/img.jpg 'title')

复制代码

头像
author

  • mackdown-背景色

markdown本身不支持背景色,但是可以使用html标签来实现

### 利用table的bgcolor属性

<table>
    <tr>
        <td bgcolor=red>table方式</td>
    </tr>
</table>

### 利用原始html的方式,因为mackdown兼容html

<p style="background:orange">原始方式</p>

复制代码
table方式

html原始方式

  • mackdown-表格

对齐方式:冒号在左边表示左对齐,右边表示有对齐,两边都有表示居中。

姓名|性别|年龄
:---|----:|:----:|
一号|男|12
二号|女|13
三号|男|14

复制代码
姓名 性别 年龄
一号 12
二号 13
三号 14
  • mackdown-锚点

语法可参考链接语法,


 (source):[目标点](#target)

 (target):定义id 或者 目标点{#target}

复制代码

好像掘金不支持,跟原本的目录导航有冲突?在vscode编辑的时候是ok的,也不知道是不是有什么错误,知道的朋友可以留言!

  • 其他

还有一些其他的高级语法,这些一般情况下很少用到,用到的时候可以专门去查一下对应的语法,这里也就不做具体说明

  1. Latex数学公式
  2. 流程图
  3. 序列图
  4. 甘特图
  5. ....

最后!如果感觉文章对你有帮助请留下个脚印吧!如果文章哪里有错误也请留下点痕迹吧!