更新时间: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. 微信小程序中scroll-view的几个坑

    微信小程序中scroll-view的几个坑 1:设置scroll-x时,却不能横向滚动,因为view是block组件,但是这里用了flex就不能滚动了(想用flex布局,请开启属性enable-fle ...

  2. JavaScript自动播放背景音乐

    问题描述 js控制audio自动播放音乐时报错: Uncaught (in promise) DOMException 我的报错之前的代码: <audio id="myaudio&qu ...

  3. selenium自动化测试-浏览器基本操作

    webdriver 通过协议和接口发现DOM中的元素,并实现控制浏览器的行为,例如打开浏览器.控制浏览器大小. 浏览器刷新及浏览器前进.后退等,接下来介绍浏览器的一些基本操作. 1.启动浏览器 dri ...

  4. springboot系列之03-使用IDEA完成第一个示例程序

    未经允许,不得转载 原作者:字母哥博客 本文完整系列出自:springboot深入浅出系列 一.使用IntellijIDEA建立第一个spring boot 项目 通常只有专业版付费版才默认带有Spr ...

  5. c#学习路线应该靠谱

    因为学c/c++,找不到工作.想转c#,搜索得到的学习路线 C#入门经典 C#数据库入门经典 C#高级编程 ADO.net高级编程 基础的东西搞明白之后,可以学习设计模式,C#设计模式 你是说深入的书 ...

  6. 阿里云服务器CentOS6.9安装jenkins

    jenkins安装 jenkins安装方式好几种,此处介绍基于tomcat安装,比较方便. 首先,通过官网下载jenkins.war文件,下载地址:https://jenkins.io/ 下载完成,将 ...

  7. 初识Hiberante框架和第一个案例

    今天想回顾一下一个月前学的hibernate框架,也让我了解了持久层的概念(访问数据库). 一.ORM概念 首先提的是ORM概念,O表示Object, R表示Relation(关系),关系型数据库,如 ...

  8. ping本地局域网

    #!/bin/bash for i in `seq 1 254` do ping -c 1 192.168.192.$i > /dev/null if [ $? -eq 0 ];then ech ...

  9. 从零开始搭建WebAPI Core_SqlSugar管理系统 (持续更新中......)

    从零开始搭建WebAPI Core_SqlSugar管理系统 前言 本系列皆在从零开始逐步搭建,后台管理系统服务端部分,后续还会推出前端部分. 这次的目的是搭出一个功能完善的 本次系列技术栈以下几个部 ...

  10. 从 axios 源码中了解到的 Promise 链与请求的取消

    axios 中一个请求取消的示例: axios 取消请求的示例代码 import React, { useState, useEffect } from "react"; impo ...