• markdown文件的基本常用编写语法


    什么是 Markdown

    Markdown 是一种轻量级标记语言,创始人为约翰·格鲁伯(John Gruber)。它允许人们「使用易读易写的纯文本格式编写文档,然后转换成有效的XHTML(或者HTML)文档 」—— 维基百科>Markdown具有一系列衍生版本,用于扩展Markdown的功能(如表格、脚注、内嵌HTML等等),这些功能原初的Markdown尚不具备,它们能让Markdown转换成更多的格式,例如LaTeX,Docbook。Markdown增强版中比较有名的有Markdown Extra、MultiMarkdown、 Maruku等。这些衍生版本要么基于工具,如Pandoc;要么基于网站,如GitHub和Wikipedia,在语法上基本兼容,但在一些语法和渲染效果上有改动。如果你看不懂以上对 Markdown 的定义,那也无所谓。约翰·格鲁伯自己对Markdown的描述的重点也在于

    1、标题的几种写法:

    第一种:

     
    image
     
    image

    前面带#号,后面带文字,分别表示h1-h6,上图可以看出,只到h6,而且h1下面会有一条横线,注意,#号后面有空格

    第二种:

     
    image
     
    image

    这种方式好像只能表示一级和二级标题,而且=和-的数量没有限制,只要大于一个就行

    第三种:

     
    image
     
    image

    这里的标题支持h1-h6,为了减少篇幅,我就偷个懒,只写前面二个,这个比较好理解,相当于标签闭合,注意,标题与#号要有空格

    那既然3种都可以使用,可不可以混合使用呢?我试了一下,是可以的,但是为了让页面标签的统一性,不建议混合使用,推荐使用第一种,比较简洁,全面

    为了搞清楚原理,我特意在网上搜一下在线编写markdown的工具,发现实际上是把这些标签最后转化为html标签,如图:

     
    image

    在线地址请看这里: markdown在线编辑 (只是想看看背后的转换原理,没有广告之嫌)

    2、列表

    我们都知道,列表分为有序列表和无序列表,下面直接展示2种列表的写法:

     
    image
     
    image

    可以看到,无序列表可以用* , + , — 来创建,用在线编辑器看,实际上是转换成了ul>li ,所以使用哪个都可以,推荐使用*吧(经参考github上的项目,建议采用-)

     
    image
     
    image

    有序列表就相对简单一点,只有这一种方式,注意,数字后面的点只能是英文的点,特别注意,有序列表的序号是根据第一行列表的数字顺序来的,比如说:

     
    image
     
    image
     
    image
     
    image

    第一组本来是3 2 1 倒序,但是现实3 4 5 ,后面一组 序号是乱的, 但是还是显示 3 4 5 ,这点必须注意了

    3、区块引用

    比如说,你想对某个部分做的内容做一些说明或者引用某某的话等,可以用这个语句

     
    image
     
    image

    无序列表下方的便是引用,可以有多种用途,看你的需求了,用法就是在语句前面加一个 > ,注意是英文的那个右尖括号,注意空格

    引用因为是一个区块,理论上是应该什么内容都可以放,比如说:标题,列表,引用等等,看看下图:

     
    image
     
    image

    将上面的代码稍微改一下,全部加上引用标签,就变成了一个大的引用,还有引用里面还有引用,那引用嵌套引用还没有别的写法呢?

     
    image
     
    image

    上图可以看出,想要在上一次引用中嵌套一层引用,只需多加一个>,理论上可以无限嵌套,我就不整那么多了(亲测:不可无线嵌套,若超出则显示字符>),注意:多层嵌套的>是不需要连续在一起的,只要在一行就可以了,中间允许有空格,但是为了好看,还是把排版搞好吧

    4、华丽的分割线

    分割线可以由* - _(星号,减号,底线)这3个符号的至少3个符号表示,注意至少要3个,且不需要连续,有空格也可以

     
    image
     
    image

    应该看得懂吧,但是为了代码的排版好看,你们自己定规则吧,前面有用到星号,建议用减号

    5、链接

    支持2种链接方式:行内式和参数式,不管是哪一种,链接文字都是用 [方括号] 来标记。

     
    image
     
    image

    上图可知,行内式的链接格式是:链接的文字放在[]中,链接地址放在随后的()中,举一反三,经常出现的列表链接就应该这样写:

     
    image
     
    image

    链接还可以带title属性,好像也只能带title,带不了其他属性,注意,是链接地址后面空一格,然后用引号引起来

     
    image

    这是行内式的写法,参数式的怎么写:

     
    image
     
    image

    这就好理解了,就是把链接当成参数,适合多出使用相同链接的场景,注意参数的对应关系,参数定义时,这3种写法都可以:

    还支持这种写法,如果你不想混淆的话:

    其实还有一种隐式链接的写法,但是我觉得那种写法不直观,所以就不写了,经常用的一般就上面2种,如果你想了解隐式链接,可以看我文章最后放出的参考地址

    6、图片

    图片也有2种方式:行内式和参数式,

     
    image
     
    image

    用法跟链接的基本一样,唯一的不同就是,图片前面要写一个!(这是必须的),没什么好说的

    7、代码框

    这个就比较重要了,很多时候都需要展示出一些代码

    如果代码量比较少,只有单行的话,可以用单反引号包起来,如下:

     
    image
     
    image

    要是多行这个就不行了,多行可以用这个:

     
    image
     
    image

    多行用三个反引号,如果要写注释,可以在反引号后面写

    8、表格

    这个写的有点麻烦,注意看

     
    image
     
    image

    从这3种不同写法看,表格的格式不一定要对的非常起,但是为了好看,对齐肯定是最好的,第一种的分割线后面的冒号表示对齐方式,写在左边表示左对齐,右边为右对齐,两边都写表示居中,还是有点意思的,不过现实出来的结果是,表格外面并没有线框包起来,不知道别人的怎么弄的

    9、强调

     
    image
     
    image

    一个星号或者是一个下划线包起来,会转换为<em>倾斜,如果是2个,会转换为<strong>加粗

    10、转义

     
    image
     
    image

    就不一一列举了,基本上跟js转义是一样的

    11、删除线

     
    image.png
     
    image

    注:与原作不一样的是,已在文中标注出来。
    1.无序列表符号推荐-,参考了下github上的项目。
    2.引用不是无线嵌套,超出后会显示字符>,亲自测试过。

  • 相关阅读:
    ios开发UI篇—Kvc简单介绍
    iOS开发UI篇—xib的简单使用
    剥开比原看代码08:比原的Dashboard是怎么做出来的?
    剥开比原看代码07:比原节点收到“请求区块数据”的信息后如何应答?
    剥开比原看代码06:比原是如何把请求区块数据的信息发出去的
    剥开比原看代码05:如何从比原节点拿到区块数据?
    剥开比原看代码04:如何连上一个比原
    剥开比原看代码03:比原是如何监听p2p端口的
    剥开比原看代码02:比原启动后去哪里连接别的节点
    剥开比原看代码01:初始化时生成的配置文件在哪儿
  • 原文地址:https://www.cnblogs.com/jtlgb/p/13605669.html
Copyright © 2020-2023  润新知