更新时间: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. alpha测试和beta测试的区别

    alpha测试版,有点相当于内部测试,一般开发人员在场   ,是由用户做测试,但开发人员在场,一般是请用户到开发现场去测试  beta测试版,完全交给用户,由用户做测试,返回测试报告,相当于发行前的一 ...

  2. Linux6.x 更换国内比较快的yum源-通用版

    ----------更换国内比较快的yum源----------- ----------163--------- cd /etc/yum.repos.d mv CentOS-Base.repo Cen ...

  3. sql server编写archive通用模板脚本实现自动分批删除数据

    博主做过比较多项目的archive脚本编写,对于这种删除数据的脚本开发,肯定是一开始的话用最简单的一个delete语句,然后由于部分表数据量比较大啊,索引比较多啊,会发现删除数据很慢而且影响系统的正常 ...

  4. 【爬虫小程序:爬取斗鱼所有房间信息】Xpath(多线程版)

    # 本程序亲测有效,用于理解爬虫相关的基础知识,不足之处希望大家批评指正 from queue import Queue import requests from lxml import etree ...

  5. Ansible常用模块基本操作

    Ansible是一个系列文章,我会尽量以通俗易懂.诙谐幽默的总结方式给大家呈现这些枯燥的知识点,让学习变的有趣一些. 前言 对于任何一个框架,一个应用,为了更便于推广,便于使用,便于商业化,都会顺便提 ...

  6. [Note] 解决使用Workerman和apache创建wss服务时出现的 Error during WebSocket handshake: net::ERR_RESPONSE_HEADERS_TRUNCATED

    使用apache代理生成的wss服务常出现 Error during WebSocket handshake: net::ERR_RESPONSE_HEADERS_TRUNCATED 的问题,但多刷新 ...

  7. Python 必备面试基础知识-3

    今天继续分享 Python 相关的面试题,你准备好了嘛! 网络编程篇 1. 简述 OSI 七层协议 是网络传输协议,人为的把网络传输的不同阶段划分成不同的层次. 七层划分为:应用层.表示层.会话层.传 ...

  8. Spring Boot 2.X(六):Spring Boot 集成Redis

    Redis 简介 什么是 Redis Redis 是目前使用的非常广泛的免费开源内存数据库,是一个高性能的 key-value 数据库. Redis 与其他 key-value 缓存(如 Memcac ...

  9. javascript随机点名--案例

    主要知识点涉及if选择结构判断语句.数组的定义.定时器.清除定时器.日期对象的使用. 1.HTML结构 <!DOCTYPE html> <html> <head> ...

  10. Mysql数据类型TINYINT(1)与BOOLEAN踩坑记

    熟悉Mysql的同学应该都知道,Mysql查询的boolean结果将输出为0或者1. 比如: ; 其输出结果为1. 查阅mysql官方文档仅找到如下描述: 11.10 Using Data Types ...