zoukankan      html  css  js  c++  java
  • The usage of Markdown---标题

    更新时间:2019.09.14

    目录:
    1. 序言
    2. 标题
      2.1 类Atx形式
      2.2 类Setext形式
    3. 总结

    1. 序言

      Markdown是一种纯文本的标记语言,只要熟悉Markdown的语法,就能写出简洁明了的文章,也再不用调格式调到心累了脸红。另外,现在有许多编辑器都支持markdown的编写,能够跨平台使用,并且兼容HTML语法。
      但是有个巨坑就是,Markdown语法并没有统一的标准。对于不同的编辑器,所用的Markdown语法可能略有差异(有时这点差异也是够折腾的流汗)。
      由于我经常使用jupyter notebook,并且有时写一下博客,都需要使用markdown来编写。因此,分几个篇章总结一下Markdown的语法(主要是针对jupyter notebook和博客园的)。

    • ps:放在一起实在太过臃肿,因此选择分开呈现(而且也方便查看)。

    2. 标题

    2.1 类Atx形式

      我们通常多个数量的#来表示多级标题(类Atx的形式),并且最多能够表示6级标题。

    # 一级标题
    ## 二级标题
    ### 三级标题
    #### 四级标题
    ##### 五级标题
    ###### 六级标题
    
    • tip1:在jupyter notebook的命令行模式(按ESC)中,可以通过按1~6来将代码块切换到标题1~6级
    • tip2: 在显示上jupyter notebook的四五六级标题并没有明显的差别,并且table of contents最多显示到四级标题
    • tip3:博客园的五六级标题并没有太大的差别

    以下是博客园的显示效果:

    一级标题

    二级标题

    三级标题

    四级标题

    五级标题
    六级标题

    以下是jupyter notebook的显示效果:
    jupyter notebook的标题显示(类Atx)



    #### 2.2 类Setext形式   除此之外,还有一种不常用的语法(类`Setext`的形式)来表示一二级标题(在jupyter notebook中要使用两个符号以上) - 使用任意数量的等号`=`来表示一级标题 - 使用任意数量的连号符`-`来表示二级标题
    一级标题
    =
    
    一级标题
    ==
    
    二级标题
    ------
    

    以下是博客园的显示效果:

    一级标题

    一级标题

    二级标题


    以下是jupyter notebook的代码和显示效果:
    jupyter notebook的标题显示(类Setext)


    **ps:**反正如果用这种表示方法,`=`和`-`就按多几个,最好就不用这种方法眯眯眼表情
    ###3. 总结   经过上面几个例子的比较就知道不同的Markdown的编辑器多多少少都有点不同,我们只要从大体上掌握Markdown的语法,并熟悉几款常用的Markdown编辑器就可以了。   对于标题,就直接用类Atx形式就好了,这也是最常用的。而类Setext形式的标题只要了解一下就好了。
  • 相关阅读:
    解决MVC的Controller和Web API的Controller类名不能相同的问题
    SSO的踢人模式/禁入模式
    os处理文件
    pyton mock
    python xml转换成json
    python调用jpype
    Python程序的执行过程原理(解释型语言和编译型语言)
    python 字典、列表、字符串 之间的转换
    python接口自动化1
    不用框架,原生使用python做注册接口/登陆接口/充值接口的测试,做的数据/代码分离
  • 原文地址:https://www.cnblogs.com/liangjianli/p/11518043.html
Copyright © 2011-2022 走看看