更新时间: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的显示效果:



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

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

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

一级标题

一级标题

二级标题


以下是jupyter notebook的代码和显示效果:


**ps:**反正如果用这种表示方法,`=`和`-`就按多几个,最好就不用这种方法

###3. 总结
  经过上面几个例子的比较就知道不同的Markdown的编辑器多多少少都有点不同,我们只要从大体上掌握Markdown的语法,并熟悉几款常用的Markdown编辑器就可以了。
  对于标题,就直接用类Atx形式就好了,这也是最常用的。而类Setext形式的标题只要了解一下就好了。

The usage of Markdown---标题的更多相关文章

  1. Markdown 标题

    用 Markdown 书写时,只需要在文本前面加上 # 即可创建标题,Markdown 支持六级标题,语法及效果如下 # 一级标题 ## 二级标题 ### 三级标题 #### 四级标题 ##### 五 ...

  2. 从0到1写一款自动为Markdown标题添加序号的Jetbrains插件

    1. markdown-index 最近做了一个Jetbrains的插件,叫markdown-index,它的作用是为Markdown文档的标题自动添加序号,效果如下: 目前已经可以在Jetbrain ...

  3. 用markdown学习写出总结

    # PS### 快捷键:CTRL+N(新建)CTRL+1. **切片**- 套索,磁性套索,椭圆,矩形选框.2. **印章** 仿制图章工具,图案图章工具3. 钢笔4. 油漆桶5. 吸管工具, *** ...

  4. 开始使用MarkDown写博客

    MarkDown 标题 #h1 ##h2 ###h3 h1 h2 h3 代码段 代码段缩进4个空格即可,如下: <div class="form-group"> < ...

  5. markdown syntax

    Markdown 语法 转载自https://zh.mweb.im/markdown.html 首先应该了解的 每一个 Markdwon 使用者都应该了解的,是 Markdown 最基本的版本,也就是 ...

  6. Pandoc中的Markdown语法

    概述 Pandoc中支持扩展修订版本的Markdown语法 使用pandoc中支持的Markdown语法用 -f markdown 使用标准Markdown语法用 -f markdown_strict ...

  7. Markdown 常用语法总结

    注意:Markdown使用#.+.*等符号来标记,符号后面必须跟上至少跟上 1个空格才有效! Markdown的常用语法 标题 Markdown标题支持两种形式. 1.用#标记 在标题开头加上1~6个 ...

  8. markdown简单使用

    Markdown介绍: ​ Markdown是一种轻量级标记语言,它允许人们使用易读易写的纯文本格式编写文档.使用Markdown编写的文档可以导出为HTML.Word.图像.PDF等多种格式的文档. ...

  9. Markdown小结

    Markdown标题 以# (#号加空格)开头的行会被视为标题,根据#的数量分为一到六级标题 # 一级标题 ## 二级标题 … ###### 六级标题 Markdown 水平线 一行由三个以上连续的减 ...

  10. markdown常用知识点

    为什么要用markdown写开发文档? 1.可以在git上在线预览,docx文档需要下载才能看见: 2. .md文档每次修改之后能被git管理,可追踪修改内容和修改人,但是docx不能追踪修改内容. ...

随机推荐

  1. 建议收藏 - 专业的MySQL开发规范

    为了项目的稳定,代码的高效,管理的便捷,在开发团队内部会制定各种各样的规范 这里分享一份我们定义的MySQL开发规范,欢迎交流拍砖 数据库对象命名规范 数据库对象 命名规范的对象是指数据库SCHEMA ...

  2. FTP无法登录问题-内有网盘福利

    http://dinghuqiang.blog.51cto.com/19871/701185/ 一顿操作猛如虎,还是没解决. 然后我想想,会不会是浏览器缓存问题? 换个火狐登录看看! 哇擦!看到报错了 ...

  3. ABP增加记录EFCore 生成数据库脚本日志到新的txt文件

    由于EFCore并没直接生成脚本到txt文件,故而自己画了点时间把实现记录下来,方便给大家参考. 0.安装Microsoft.Extensions.Logging.Debug,我这里是2.1.1版本. ...

  4. Spring 梳理-bean作用域

    Spring定义了多种域 单例(Singleton):在整个应用中,只有一个实例 原型(Prototype):每次注入或者通过Spring应用上线文获取时,都创建一个bean实例 会话(Session ...

  5. css或Angular框架限制文本字数

    提需求的来了 某一期产品迭代时,新增了一个小功能,即:在单元格中的文本内容,字符超过20个字的时候,需要截断,并显示20个字符+一个省略号,未超过,无视. 这需求看上去不怎么复杂,看起来可以用css做 ...

  6. 设计模式之UML类图以及类间关系

    类图是描述系统中的类,以及各个类之间的关系的静态视图.能够让我们在正确编写代码以前对系统有一个全面的认识.类图是一种模型类型,确切的说,是一种静态模型类型.类图表示类.接口和它们之间的协作关系. 以下 ...

  7. jQuery常用方法(一)-基础

    $("p").addClass(css中定义的样式类型); 给某个元素添加样式 $("img").attr({src:"test.jpg", ...

  8. 体验StartOS

    旧电脑,原来使用的是win xp.随着win及其支持打软件打“成长”,电脑运行越来越慢了.一个操作需要很长的时间等待,终于,失去了耐心,换了新的电脑. 旧电脑弃置多年,留之无用,弃之可惜.偶发奇想,换 ...

  9. Scala XML

    XML 直接在代码中使用 XML 字面量 val doc: Elem = <html><head><title>Test</title></hea ...

  10. 《构建之法》MSF&需求分析

    第七章 MSF MSF基本原则 推动信息共享与沟通 为共同的远景而工作 充分授权和信任 各司其职,对项目共同负责 交付增量的价值 保持敏捷,预期和适应变化 投资质量 学习所有的经验 与顾客合作 MSF ...