美文网首页MarkDown
Markdown语法总结

Markdown语法总结

作者: 日居_月诸 | 来源:发表于2018-06-06 20:34 被阅读1380次

    0.目录(Table of Contents)

    在需要目录出现的地方放置一个标记,这样会自动生成一个嵌套的包含所有标题的列表。默认的标记是 [TOC]。

    [TOC]

    注:简书不支持该语法,Typora、马克飞象、Cmd Markdown等编辑器支持。

    1.标题(Headers)

    Markdown 标题支持两种形式:

    1.1用1~6个#标记

    在 标题开头 加上1~6个#,依次代表一级标题、二级标题....六级标题

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

    一级标题

    二级标题

    三级标题

    四级标题
    五级标题
    六级标题

    1.2用=和-标记

    在 标题底下 加上任意个=代表一级标题,-代表二级标题

    一级标题
    ======
    
    二级标题
    ----------
    

    一级标题

    二级标题

    2.列表(Lists)

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

    2.1无序列表(Unordered Lists)

    无序列表使用-、+和*作为列表标记:

    -  Red
    - Green
    - Blue
    
    * Red
    * Green
    *  Blue
    
    +  Red
    + Green
    + Blue
    
    • Red
    • Green
    • Blue
    • Red
    • Green
    • Blue
    • Red
    • Green
    • Blue

    2.2有序列表(Ordered Lists)

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

    1. Red
    2. Green
    3. Blue

    3.引用(Reference)

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

    3.1常见的引用写法:

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

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

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

    代码例子:

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

    3.2分级引用

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

    一级引用

    二级引用

    三级引用

    这是一个四级标题

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

    建立多级列表时,每个子级别都要比上个级别前面多打2个以上空格。
    在 「 * 」 前加两个空格键或者一个 tab 键就可以产生一个子列表。
    有序列表: 在文本前加 「字母.」 或 「数字.」 即可生成一个有序列表。
    注意,当你第一个序号使用什么作为标记的,那么同级别的列表就会自动使用其作为标记。

    4.文字样式(Text Styling)

    4.1. 基本语法

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

    **加粗文本** 或者 __加粗文本__
    *斜体文本*  或者 _斜体文本_
    ***斜粗体*** 或者 ___斜粗文本___
    ~~删除文本~~
     :==高亮 #807700==或者==高亮==
    ` 底纹 `
    

    加粗文本 或者 加粗文本
    斜体文本 或者 斜体文本
    斜粗体 或者 斜粗文本
    删除文本
    :==高亮 #807700==或者==高亮==
    底纹

    4.2.非基本语法

    字体上标(superscript)和下标(subscript )

    4.2.1简书中,字体上、下标的语法为:

    <sup>上标文字</sup>
    <sub>下标文字</sub>
    

    上标文字
    下标文字
    这是上标文字
    这是下标文字

    4.2.2Typora 中,字体上、下标的语法为:

    这是^上标文字^
    这是~下标文字~
    

    这是上标文字
    这是下标文字

    5.图片与链接(Images & Links)

    图片与链接的语法很像,区别在一个 ! 号。
    注:Markdown 不能设置图片大小,如果必须设置则应使用HTML标记 <img>

    图片:![]() ![图片描述(可忽略)](链接的地址)
    链接:[]() [链接描述](链接的地址)
    
    This is [an example](http://example.com/ "Title") inline link.
    [This link](http://example.net/) has no title attribute.
    

    This is an example inline link.
    This link has no title attribute.

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

    内联(Inline):以中括号[]标记显示的链接文本,后面紧跟用小括号()包围的链接。 如果链接 Title 属性,则在链接中使用空格加"Title 属性",即Title

    这是行内式链接:[Mou](http://25.io/mou/)。
    
    这是参考式链接:[Mou][url],其中url为链接标记,可置于文中任意位置。
    
    [url]: 25.io/mou/
    

    这是行内式链接:Mou

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

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

    这是自动链接:直接使用`<>`括起来<http://25.io/mou/>
    

    这是自动链接:直接使用<>括起来http://25.io/mou/

    这是图片:![][Mou icon]
    
    [Mou icon]: http://mouapp.com/Mou_128.png
    
    这是图片: GitHub Mark

    6.代码块引用(Fenced Code Blocks)

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

    6.1行内代码

    行内代码使用 代码 标识,可嵌入文字中
    需要引用代码时,如果引用的语句只有一段,不分行,可以用 ` 将语句包起来。

    `Hello world`
    

    Hello world

    6.2代码框

    两对「 」包裹,如果引用的语句为多行,可以将 置于这段代码的首行和末行。
    代码前加四个空格键
    代码前加一个 tab 键

    ​```
    Code Line 1
    Code Line 2
    Code Line 3
    ​```
    
    Code Line 1
    Code Line 2
    Code Line 3
    

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

    ​``` 语言
    //注意语言前面有空格
    这里是代码
    ​```
    
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
    }
    

    7.表格(Tables)

    表格对齐格式
    居左::----
    居中::----:或-----
    居右:----:
    例子:

    |标题|标题|标题|
    |:---|:---:|---:|
    |居左文本|居中文本|居右文本|
    
    标题 标题 标题
    居左文本 居中文本 居右文本

    8.分隔线

    在一行中用三个以上的、-、_来建立一个分隔线,行内不能有其他东西。也可以在符号间插入空格。
    在一行中使用三个或三个以上的
    、-或_可以添加分隔线,中间插入空格,但是不能有其他字符。

    ***
    ---
    _____
    
    * * *
    




    效果均为一条分割线

    9.脚注|注解(Footnotes)

    9.1使用[^]来定义脚注:

    这是一个脚注的例子[^1]
    [^1]: 这里是脚注
    

    这是一个脚注的例子[1]

    9.2注释

    注释是给自己看的,预览时也不会出现,当然发布出去别人也不会看见。

    <!--注释-->
    

    10.常用弥补Markdown的Html标签

    10.1字体

    <font face="微软雅黑" color="red" size="6">字体及字体颜色和大小</font>
    <font color="#0000ff">字体颜色</font>
    

    <font face="微软雅黑" color="red" size="6">字体及字体颜色和大小</font>
    <font color="#0000ff">字体颜色</font>

    10.2换行

    使用html标签`<br/>`<br/>换行
    

    使用html标签<br/>
    换行

    10.3文本对齐方式

    <p align="left">居左文本</p>
    <p align="center">居中文本</p>
    <p align="right">居右文本</p>
    

    <p align="left">居左文本</p>
    <p align="center">居中文本</p>
    <p align="right">居右文本</p>

    10.4下划线

    <u>下划线文本</u>
    

    <u>下划线文本</u>

    11.任务列表

    - [ ] [links](), **formatting**, and ~~tags~~ supported
    - [x] list syntax required (any unordered or ordered list supported)
    - [ ] this is a complete item
    - [x] this is an incomplete item
    
    • [ ] links, formatting, and tags supported
    • [x] list syntax required (any unordered or ordered list supported)
    • [ ] this is a complete item
    • [x] this is an incomplete item
      注:简书不支持该语法,Typora、Day One 2、马克飞象、Cmd Markdown等编辑器支持。

    12.转义字符(Backslash Escapes)

    Markdown 可以利用反斜杠\来插入一些在语法中有其它意义的符号,例如:如果想要用星号加在文字旁边的方式来做出强调效果,可以在星号的前面加上反斜杠:

    \*literal asterisks\*
    

    *literal asterisks*


    1. 这里是脚注

    相关文章

      网友评论

        本文标题:Markdown语法总结

        本文链接:https://www.haomeiwen.com/subject/cnyisftx.html