Markdown是什么?

Markdown 是一种轻量级标记语言,创始人为约翰·格鲁伯(John Gruber)。 它允许人们使用易读易写的纯文本格式编写文档,然后转换成有效的 XHTML(或者HTML)文档。这种语言吸收了很多在电子邮件中已有的纯文本标记的特性。

由于 Markdown 的轻量化、易读易写特性,并且对于图片,图表、数学式都有支持,许多网站都广泛使用 Markdown 来撰写帮助文档或是用于论坛上发表消息。如 GitHub、Reddit、Diaspora、Stack Exchange、OpenStreetMap 、SourceForge、简书等,甚至还能被使用来撰写电子书。

基础Markdown语法

标题如何写?

标题不仅是我们写文章的中心体现,在Markdown中使用[TOC]关键字还可以自动根据标题顺序生成目录,非常便捷。

标题有两种写法
1:在想要生成标题的行下书写至少一个以上的等号或减号,分别对应一级标题与二级标题,如:
一级标题 二级标题
======= -------
2:使用"#"号,每有一个井号代表标题级数加一,级数限制为6,当然,目录次序也会随级数增大而自动缩进,快去试试吧。

倾斜、加粗、高亮文本

Markdown对文字的标记如下所示:

    对文本进行倾斜、加粗、粗斜体文字依靠*号或_下划线;

    写法:将想要操作的文字夹在*号或_之间,如*我被倾斜了*

    将文本倾斜有两种写法:两个单星号或两个单下划线,将文字添加到这两个单星号之间即可。如:*斜体*

    将文本加粗同上方写法一样,只不过将单个星号或单下划线换成了左右双星号。

    粗斜体便是三个上方所述。

高亮文字:

==高亮文字包含在两个等号之间即可==

分割、删除、下划线

分割线:

1:连续的三个以上的*号即可
2:星号与空格间隔书写,如:* * *
3:减号与空格间隔书写,如:- - -

删除线:

~~将删除线上的文字包含在两个波浪号之间即可~~

下划线:

<u>下划线上的文字包含在U标签里即可</u>

列表、区块、表格

无序列表

三种写法,仅左侧单星、单加号、单减号+空格+文字即可

格式如下所示:
* 无序列表
+ 无序列表
- 无序列表

有序列表

使用1.加空格即可,不同的markdown编辑器对有序列表的反应处理不同,这里我们简单理解为自己使用序号标注即可(但是可以自由与无序列表嵌套)。

1. 有序列表
2. 有序列表

区块

有时候我们也可使用区块表示层级效果,区块效果:

区块引用

二级区块(嵌套)

三级区块(嵌套)

三级区块(非嵌套)

书写格式:

使用右箭头,每增加一个右箭头递进关系就增加一层,上方效果的书写格式:

>区块引用
>>二级区块(嵌套)
>>>三级区块(嵌套) >>>三级区块(非嵌套)

无序列表、有序列表、区块可以自由嵌套,快去试试吧。

表格

Markdown 制作表格使用 | 来分隔不同的单元格,使用 - 来分隔表头和其他行。

语法格式如下:

|  表头   | 表头  |
| ---- | ---- |
| 单元格 | 单元格 |
| 单元格 | 单元格 |

我们可以在分割行中设置表格的对齐方式:

-: 设置内容和标题栏居右对齐。

:- 设置内容和标题栏居左对齐。

:-: 设置内容和标题栏居中对齐。

格式如下:

| head | head2| head3|
| :------|:-------:| -------:|
| tab | tab2| tab3|
| tab | tab | tab3|

链接、脚注

文章内链接

效果:跳转至文章末尾

跳转至文章末尾

跳转回来了

格式:

[jump](#1)
<span id="1">文本内容</span>

跳转链接

Markdown中链接类型的通用书写格式:[链接名称](链接地址)

效果:

this is a link

这是一个链接cnblogs

https://www.cnblogs.com

书写格式:

this is a [link](https://www.cnblogs.com)

这是一个链接[cnblogs](https://www.cnblogs.com)

<https://www.cnblogs.com>

使用变量控制链接地址

我们可以通过变量来设置一个链接,变量赋值在文档末尾进行:

效果如下:

这个链接用变量1作为网址变量 Google

这个链接用myblogs作为网址变量 myblogs

然后在文档的结尾为变量赋值(网址)

格式:

这个链接用变量1作为网址变量 [Google][1]
这个链接用myblogs作为网址变量 [myblogs][myblogs]
然后在文档的结尾为变量赋值(网址) [1]: http://www.google.com/
[myblogs]: https://cnblogs.com/lele0120

脚注

脚注的作用不多叙述,我们来看看效果:

创建一个脚注[1]

上方效果的书写格式:

创建一个脚注[^jiaozhu]
[^jiaozhu]:这是一个脚注

插入图片、视频

插入图片

在Markdown中插入图片有两种方式,一种是markdown的![alt 属性文本](图片地址 "可选标题"),另一种方式是使用css的img标签

书写格式:

1.开头一个感叹号 !
2.接着一个方括号,里面放上图片的替代文字,当图片加载不出来时显示的替代内容。
3.接着一个普通括号,里面放上图片的网址,最后还可以用引号包住并加上选择性的 'title' 属性的文字。这个文字是当你鼠标移动至图片上时对图片的解释。 css标签:
<img src="https://xxx.png" width="50%">

效果:



插入视频

使用video标签:

<video   controls="controls" autoplay="autoplay">
<source src="链接可以为本地或网上的地址.mp4" width="50%">
</video>

转义符、图标元素

转义符

如同大多数编程语言一样,我们可以使用\对目标关键字进行转义。

图标元素

不在 Markdown 涵盖范围之内的标签,都可以直接在文档里面用 HTML 撰写。

例如:

使用 Ctrl+Alt+Del 重启电脑

使用 <kbd>Ctrl</kbd>+<kbd>Alt</kbd>+<kbd>Del</kbd> 重启电脑

为什么写下这篇文章

作为本人的初篇随笔,再三思考下还是决定先写初这篇文章;虽然Markdown在学校时经常使用,但是这一年来不怎么用,便是有些生疏了,写下这篇文章正好复习复习以给写博客打下基础。

跳转至文章末尾了

点击跳转回去


  1. 这是一个脚注

如何使用Markdown编写笔记的更多相关文章

  1. Markdown 编写规范

    说明及目的 作为一个在博客园混迹了俩三年的人,一直在这里看别人的博客,现在准备开始写自己的博客,目的呢,就是一下几点吧: 项目过程中的历史经验教训积累记载,吃一堑长一智,不想在同一个坑掉进去好几次 学 ...

  2. Markdown 学习笔记: Basics

    Markdown 学习笔记: Basics 原文:Basics. 了解Markdown格式化句法的要点 本页对如何使用Markdown提供了一个简单的概述.在"句法"页中对Mark ...

  3. MarkDown编写规范指南

    Markdown 编写规范指南 简介: Markdown的目标是实现「易读易写」,成为一种适用于网络的「书写语言」. 一份使用Markdown格式撰写的文件可以直接以纯文本发布,它的最大灵感来源其实是 ...

  4. 基于 Markdown 编写接口文档

    最近公司开发项目需要前后端分离,这样话就设计到后端接口设计.复杂功能需要提供各种各样的接口供前端调用,因此编写API文档非常有必要了 网上查了很多资料,发现基于Markdown编写文档是一种比较流行而 ...

  5. PADS VBA 编写笔记

    PADS VBA 编写笔记 由于 PADS 的中编码不是 utf8 的,所以在编写时放到 PADS 中会出现乱码. 有时会使用中文注释,但是当以中文注释结尾时就会出现错误,于是就如果结尾是以英文就没问 ...

  6. Markdown编写github README.md

    Markdown编写github README.md 一.在线编辑器StackEdit Markdown在线编辑器地址 中文:https://www.zybuluo.com/mdeditor 英文:h ...

  7. Markdown 编写技巧汇总(一)

    编写文档,有很多格式选择,也有不同平台选择.下面就自己接触到的MarkDown编写文档的各种技巧做简单梳理,供自己参阅,也希望帮到网友. [1]添加空格 ①   这种写法比较老土,但是,很实用!注意都 ...

  8. 【转载】Markdown使用笔记

    献给写作者的 Markdown 新手指南 http://www.jianshu.com/p/q81RER 「简书」作为一款「写作软件」在诞生之初就支持了 Markdown,Markdown 是一种「电 ...

  9. 我的 MarkDown 学习笔记

    MarkDown 一种用于写作的轻量级[标记语言].它用简洁的语法代替排版,而不像一般的文字处理软件 Word 或者 Pages 有大量的排版.字体设置等. 如果你对文章的样式没有太多要求,只注重写文 ...

  10. MarkDown 学习笔记

    MarkDown是一种适用于网络的书写语言,可以帮助你快速书写文档,不必再纠结文档排版的问题.并且它的语法简单,学习成本低,程序员必备技能...助你快速书写技术文档.文章. 用于书写 MarkDown ...

随机推荐

  1. C++学习笔记七:输出格式<ios><iomanip>

    这一篇主要总结一下C++标准库里输出格式相关的库函数. https://en.cppreference.com/w/cpp/io/manip 1.库: <ostream> <ios& ...

  2. 启发式搜索(heuristic search)———A*算法

    在宽度优先和深度优先搜索里面,我们都是根据搜索的顺序依次进行搜索,可以称为盲目搜索,搜索效率非常低. 而启发式搜索则大大提高了搜索效率,由这两张图可以看出它们的差别: (左图类似与盲搜,右图为启发式搜 ...

  3. ElasticSearch之Index modules

    索引的参数,分为两类: 静态参数,仅支持在创建索引时指定,或者关闭索引后指定. 动态参数,允许在索引工作期间指定或者修改. 静态参数 index.number_of_shards 默认值为1. 本参数 ...

  4. ElasticSearch之Shard request cache settings

    对于查询操作,Elasticsearch提供了缓存特性来暂存结果. 对于相同条件的查询请求,在缓存中的数据失效前,响应后续的查询操作时可以直接从缓存中提取结果,有效降低检索操作的时延,提升检索数据时的 ...

  5. javacv实现屏幕录制(一)

    javacv实现屏幕录制(一) javacv从入门到入土系列,发现了个好玩的东西,视频处理,于是我想搞个屏幕录屏,我百度了一下,copy那些代码我没有实现过,那些代码也没有说明,只好去官网看文档找资料 ...

  6. android ProgressBar样式

    实现进度条由浅黄(#ffff33)到深黄色(#ff6600)的渐变样式. 与进度条自动从0加载到99,进度条每次加1 android:max:进度条的最大值. android:progressDraw ...

  7. JavaImprove--Lesson04--LocalDateTime,ZoneId,Instant,DateTimeFormatter

    一.LocalDateTime LocalDateTime是JDK8的新时间特性,它解决了Date类和Calender类的很多不足,如使用不方便,线程不安全,以及获取时间戳只能拿到毫秒而不能拿到纳秒等 ...

  8. spring-mvc 系列:域对象共享数据

    目录 一.使用ServletAPI向request域对象共享数据 二.使用ModelAndView向request域对象共享数据 三.使用Model向request域对象共享数据 四.使用Map向re ...

  9. 案例解析丨金蝶K/3 Wise接入华为云RDS数据库SQL Server

    1. 简介 企业或用户将数据中心部署在线下,采用独立软件提供商(Independent Software Vendor)软件进行管理.线下数据运维成本较高,故障容灾单一化,是目前遇到的瓶颈.采用云上数 ...

  10. 带你认识Flink容错机制的两大方面:作业执行和守护进程

    摘要:Flink 容错机制主要有作业执行的容错以及守护进程的容错两方面,前者包括 Flink runtime 的 ExecutionGraph 和Execution的容错,后者则包括 JobManag ...