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. 记录一些JDK的新特性~持续更新

    1.record快速定义类 @Test public void testRecord() { /** * JDK16新特性 * * @param start * @param end */ recor ...

  2. hello Flask最简单的Flask项目

    # 1.导包 from flask import Flask # 2.实例化Flask对象.一般变量名都叫app,大家都是这样用,很多扩展插件的文档也是叫app,所以统一都叫app. # __name ...

  3. 【Python】【OpenCV】定位条形码(一)

    关于二维码和条形码的检测和识别,在OpenCV中已经有提供了对应的API,cv2.QRCodeDetector() | cv2.barcode_BarcodeDetector() ,相关的实现极其简单 ...

  4. Ubuntu图形界面root登录“sorry, that didn't work please

    https://blog.51cto.com/u_14757092/2484490 ssh登录主机执行下vim /etc/pam.d/gdm-autologin 注释行 "auth requ ...

  5. MinIO FTP 断点续传

    MinIO FTP 断点续传 对于minio来说,使用minio官方的Java SDK和开启FTP都是不支持断点续传的.对于要实现http接口的断点续传,可以通过调用Amazon S3 REST AP ...

  6. Java 中时间对象的序列化

    在 Java 应用程序中,时间对象是使用地比较频繁的对象,比如,记录某一条数据的修改时间,用户的登录时间等应用场景.在传统的 Java 编程中,大部分的程序员都会选择使用 java.uti.Date ...

  7. python Django api 返回图片

    re_path(r"report_img/(.*)$",views.ReportImage.as_view()) def return_img(request): img_dir ...

  8. Flume快速入门

    Flume快速入门 一.简介 高可用.高可靠,分布式的海量日志采集.聚合和传输系统,基于流式架构,灵活简单. event:事件 source:数据源 sink:目标 channel:数据管道 通过获取 ...

  9. LeetCode刷题(不断更新)

    冲冲冲 125. 验证回文串 给定一个字符串,验证它是否是回文串,只考虑字母和数字字符,可以忽略字母的大小写. 说明:本题中,我们将空字符串定义为有效的回文串. 示例 1: 输入: "A m ...

  10. EDS从小白到专家丨打造数据交换的六边形卫士,让你的数据你做主

    本文分享自华为云社区<[EDS从小白到专家]第4期:打造数据交换的六边形卫士,让你的数据你做主>,作者: 开天aPaaS小助手 . 你还在担心数据共享后一旦"失控"将爆 ...