markdown语法

作者: Jorgezhong | 来源:发表于2018-08-28 16:17 被阅读240次

      学习markdown?当然是为了做做笔记,脑子不好就只能动动手指啦。
      以往做笔记是用的OneNote,但是一段事件下来,发现记在OneNote上的东西非常多,而且不方便查找。OneNote的Copy技能太强大了有木有。在现在日常开发节奏这么快的环境下,遇到不懂的技术基本都是度娘,google一顿操作,然后过两天忘了。悲哀呀,日常学习成果就这样遗忘在时间的角落了。本人表示很愤怒,本来就是我的,凭什么丢掉。
      脑子不好只有靠别的弥补了,于是有了学习 markdown 并撰写博客的动机了。给自己的学习增加一个知识整理的过程,一个技术沉淀的载体。


    目录

    [toc]


    1:标题

    标题有六个级别,用 # 号来表示,有以下六个级别。

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

    一级标题

    二级标题

    三级标题

    四级标题

    五级标题
    六级标题

    2:列表

    markdown中里列表也有“有序”和“无序”之分。
    在文字前加上 - * + 就是无序列表,但是效果一样的,
    加上数字如 1. 2. 3. 便是有序列表。
    注:-、1. 和文本之间要保留一个字符的空格

    - 无序列表1
    - 无序列表2
    
    * 无序列表1
    * 无序列表2
    
    + 无序列表1
    + 无序列表2
    
    • 无序列表1
    • 无序列表2
    • 无序列表1
    • 无序列表2
    • 无序列表1
    • 无序列表2
    1. 有序列表1
    2. 有序列表2
    
    1. 有序列表1
    2. 有序列表2

    3:表格

    语法:

    • 列:用 | 区分每列。
    • 行:只能区分表头和表单内容,用 - 区分
    • 对齐:再相应的方向上,用 :表示,如:
      ----- 默认对其:左对齐
      ----: 为右对齐
      :---- 为左对齐
      :---: 为居中对齐
    | column | column | column | column |
    | ---: | :----: | :----- | ---- |
    |   row  | row | row | row |
    |   row  | row |     | row |
    |   row  | row | row |     |
    
    
    column column column column
    row row row row
    row row row
    row row row

    4:链接

    markdown中链接有两种:参考式、行内式。
    链接的话可以是本地资源路径,相对路径和绝对路径都是可以的

    行内式语法:[显示文本](链接地址 "title")
    链接弟子可以用<>包裹,也可以不用,效果式一样的
    title属性的效果是鼠标悬浮到显示文本上会有提示信息,跟html是一样的。不想要的话,可以省略该属性。而属性值用单引号''、双引号“”、小括号()等任意一个符号包裹都是可以的,可以试一下。

    参考式语法:
    [显示文本][引用标识]
    [引用标签]: 链接地址 "title"
    参考式语法其实就是先定义好了再使用,多了个引用标签这样,方便我们集中管理引用,万一引用的资源url变了,方便修改了。
    另外需要注意的是,参考式的链接地址和行内式的链接地址式不一样的,行内式的链接地址需要用小括号包裹,而参考式是不需要小括号的。

    行内式链接(有title):[这是百度的链接](www.baidu.com "百度")
    行内式链接(无title):[这是百度的链接](www.baidu.com)
    
    行内式链接(符号:<>):[这是百度的链接](<www.baidu.com> "百度")
    行内式链接(符号:''):[这是百度的链接](<www.baidu.com> '百度')
    行内式链接(符号:()):[这是百度的链接](<www.baidu.com> (百度))
    
    

    行内式链接(有title): 这是百度的链接
    行内式链接(无title): 这是百度的链接
    行内式链接(符号:''): 这是百度的链接
    行内式链接(符号:""): 这是百度的链接
    行内式链接(符号:()): 这是百度的链接

    参考式链接:[这是百度的链接][mark-1]
    参考式链接:[这是百度的链接][mark-2]
    参考式链接:[这是百度的链接][mark-3]
    
    [mark-1]: www.baidu.com "这是百度链接"
    [mark-2]: www.baidu.com '这是百度链接'
    [mark-3]: www.baidu.com (这是百度链接)
    
    

    参考式链接:这是百度的链接
    参考式链接:这是百度的链接
    参考式链接:这是百度的链接


    5:图片

    markdown中图片也有两种:参考式、行内式。这和链接是一样的
    路径的话可以是本地资源路径,相对路径和绝对路径都是可以的

    行内式语法:[图片上传失败...(image-ef80a8-1535444198905)]
    对比链接,也就多了个感叹号。

    参考式语法:
    ![失效显示文本][引用标识]
    [引用标签]: 图片地址 "title"
    图片的参考式语法和链接的区别也是多了一个 ! 其他都是一样的。

    行内式图片:
    ![这是百度的图片](https://img.haomeiwen.com/i11623065/9c29e8a9c85494eb.jpg?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240 "悬浮提示信息:message!!!")
    

    行内式图片:


    这是百度的图片
    参考式图片:
    ![这是百度的图片][mark-img-1]
    ![这是百度的图片][mark-img-2]
    
    [mark-img-1]:http://e.hiphotos.baidu.com/zhidao/wh%3D450%2C600/sign=08ce1447ceef76093c5e919b1bed8ffa/622762d0f703918fa4d62d10543d269758eec4e0.jpg "这是百度的图片"
    [mark-img-2]:http://img2.a0bi.com/upload/ttq/20140704/1404444786734_middle.jpg "这是百度的图片"
    
    

    参考式图片:


    这是百度的图片这是百度的图片
    这是百度的图片这是百度的图片

    建议:行内式和参考式其实更应该使用参考式,因为图片地址和链接地址这种东西都是非常长的字符串,嵌入到文本内容当中很不优雅,会用凌乱的感觉,而使用参考式则没有这个问题,另外还可以统一管理url地址。也不用担心引用标签重复的问题。


    6:代码块

    写技术博客,最常用到的就是代码引用,markdown用 ` 来表示引用代码。

    语法:

    • `单行引用`
    • ``` 多行引用
      多行引用
      多行引用
      ```
    
    单行代码引用:`LOGGER.info("message");`
    
    多行代码引用:
    
    @RunWith(SpringRunner.class)
    @SpringBootTest
    public class DemoApplicationTests {
    
        private static final Logger LOGGER = LoggerFactory.getLogger(DemoApplicationTests.class);
    
        @Test
        public void contextLoads() {
    
            LOGGER.info("message");
    
        }
    
    }
    

    7:区块引用

    语法:用 > 来表示区块引用,有多少级就加多少个。只要是连续的,貌似没有限制。如果要另外增加相邻的同级,要空一行。

    >一级引用
    >>二级引用
    >>>三级引用
    >>>>四级引用
    >>>>>五级引用
    
    >>>>>>六级引用
    >>>>>五级引用
    >>>>>>>七级引用
    
    >一级引用
    
    

    一级引用

    二级引用

    三级引用

    四级引用

    五级引用

    六级引用

    五级引用

    七级引用

    一级引用


    8:特殊字符

    特殊markdown本质上其实是和html一样的语言,因此关于特殊字符和转移和html也是一样的,可以直接用编码展示特殊字符,参照HTML ASCII 参考手册

    例如这些实体:
    &#33;   &#34;   &#35;   &#36;   &#38;   &#60;   &#62;   &#169;  &#174;  &#165;
    
    

    ! " # $ & < > © ® ¥


    9:分割线

    分割线可以用三个以上的 *- 来表示。

    ------
    被分割的内容
    ******
    

    被分割的内容



    10:文字处理

    字体处理常用的就是高亮,颜色和加粗了,当然还有下划线,斜体,这些,删除一般都不会用了。颜色的话简书貌似也不支持,尚极简风格。不然的话可以用<font>标签来设置

    • 高亮:用 == 包裹,高亮简书不支持,建议用 ` 代替
    • 斜体:用 * 包裹
    • 加粗:用 ** 包裹
    • 下划线:用 ++ 包裹
    • 删除:用 ~~ 包裹
    • 段首空两格:用 &#8195;&#8195;
    ==高亮==
    *斜体*
    **加粗**
    ++下划线++
    ~~删线~~
    
    &#8195;&#8195;段首空两格
    段首空两格,段首空两格,段首空两格。
    

    ==高亮==
    斜体
    加粗
    ++下划线++
    删线

      段首空两格
    段首空两格,段首空两格,段首空两格。


    11:生成目录

    使用[toc]就可以了,但是简书不支持。有道和csdn是可以支持的。


    12:参考文献

    参考文献的表示方式叫脚注或者尾注
    语法:[^标签]
    其实这个标签只是代码方便查看而给予的一个自定义方式,最终呈现在文本上的都是按全篇顺序排好序的文献引用。而且参考文献里欸包会自动加载到文档最魔为,分隔符是无法分割的

    XXXXX[^1] XXXXXXXXXXXXXXXX,
    XXXXX[^hello] XXXXXXXXXXXXXXXX,
    XXXXX[^正经引用] XXXXXXXXXXXXXXXX,
    XXXXX[^大学论文] XXXXXXXXXXXXXXXX
    
    [^1]: 一个很普通的参考文献。
    [^hello]: 这个很可能是自己的原创。
    [^正经引用]: 某个知名博主的发表吧,引用一下。
    [^大学论文]: 某某教授的论文,要认真标注好。
    
    

    XXXXX[1] XXXXXXXXXXXXXXXX,
    XXXXX[2] XXXXXXXXXXXXXXXX,
    XXXXX[3] XXXXXXXXXXXXXXXX,
    XXXXX[4] XXXXXXXXXXXXXXXX



    1. 一个很普通的参考文献。

    2. 这个很可能是自己的原创。

    3. 某个知名博主的发表吧,引用一下。

    4. 某某教授的论文,要认真标注好。

    相关文章

      网友评论

        本文标题:markdown语法

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