阅读 69

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 类型:利用 =(最高阶标题)和 - (第二阶标题),任意数量

H1

H2

H3

H4

H1

H2

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

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

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

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

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

我是斜体

我是粗体

倾斜加粗

删除线

  • mackdown-Blockquotes引用

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

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

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

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

这是嵌套引用

返回上一层

echo 'hello mackdown!!!'

  • mackdown-列表

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

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

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

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

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

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

<ol>
    <li>one</li>
    <li>two</li>
    <li>three</li>
</ol>
复制代码

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

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

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

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

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

使用 ```语法;

使用 <pre> 标签;

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

  • mackdown-行内代码

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

echo "Hello World!!"

  • mackdown-分隔线

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





  • mackdown-反斜杠转义

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

*我转义了*

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

  • mackdown-自动链接

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

www.baidu.com/

  • mackdown-链接

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

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

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

这是 百度 的链接.

这是 百度 的链接.

  • mackdown-图片

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

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

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

头像
author

  • mackdown-背景色

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

table方式

html原始方式

  • mackdown-表格

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

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

语法可参考链接语法,

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

  • 其他

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

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

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

关注下面的标签,发现更多相似文章
评论