markdown基本语法

时间:2024-03-13 10:37:59

  之前经常听到周围人使用markdown来写一些博客等等的文档,今天主要给大家介绍一下markdown是个什么东西,他是怎么使用的。

  首先明白markdown并不是我们平时使用的wps一样,它不是一个软件,它是一门语言

Markdown是一种可以使用普通文本编辑器编写的标记语言,通过简单的标记语法,它可以使普通文本内容具有一定的格式。

Markdown具有一系列衍生版本,用于扩展Markdown的功能(如表格、脚注、内嵌HTML等等),这些功能原初的Markdown尚不具备,它们能让Markdown转换成更多的格式,例如LaTeXDocbook。Markdown增强版中比较有名的有Markdown Extra、MultiMarkdown、 Maruku等。这些衍生版本要么基于工具,如Pandoc;要么基于网站,如GitHubWikipedia,在语法上基本兼容,但在一些语法和渲染效果上有改动

Markdown的语法简洁明了、学习容易,而且功能比纯文本更强,因此有很多人用它写博客。世界上最流行的博客平台WordPress和大型CMS如JoomlaDrupal都能很好的支持Markdown。完全采用Markdown编辑器的博客平台有GhostTypecho

用于编写说明文档,并且以“README.MD”的文件名保存在软件的目录下面。

除此之外,现在由于我们有了RStudio这样的神级编辑器,我们还可以快速将Markdown转化为演讲PPT、Word产品文档、LaTex论文甚至是用非常少量的代码完成最小可用原型。在数据科学领域,Markdown已经广泛使用,极大地推进了动态可重复性研究的历史进程。 

markdown基本语法

markdown基本语法

这是左右两个文件左边是我们使用markdown编写出来的文档, 右边就是我们编写结束之后运行的文档。

 下边就给大家简单介绍一下markdown的一些基本语法:

一、标题

在想要设置为标题的文字前面加#来表示
一个#是一级标题,二个#是二级标题,以此类推。支持六级标题。

markdown基本语法

标题等级越高字体越小。这在编辑的时候是一个十分方便的语法。不需要通过鼠标来反复调节字体大小。

二、字体

加粗

要加粗的文字左右分别用两个*号包起来

斜体

要倾斜的文字左右分别用一个*号包起来

斜体加粗

要倾斜和加粗的文字左右分别用三个*号包起来

删除线

要加删除线的文字左右分别用两个~~号包起来

markdown基本语法

三、引用

在引用的文字前加>即可。引用也可以嵌套,如加两个>>三个>>>
n个...
貌似可以一直加下去,但没神马卵用

markdown基本语法

markdown基本语法

 

五、图片

语法:

![图片alt](图片地址 ''图片title'')

 

图片alt就是显示在图片下面的文字,相当于对图片内容的解释。

图片title是图片的标题,当鼠标移到图片上时显示的内容。title可加可不加

markdown基本语法

这是在markdown下插入图片。

六、超链接

语法:

[超链接名](超链接地址 "超链接title")

title可加可不加

示例:

[简书](http://jianshu.com)

[百度](http://baidu.com)

七、列表

  •  

无序列表

  •  

语法:
无序列表用 - + * 任何一种都可以

- 列表内容

+ 列表内容

* 列表内容

 

注意:- + * 跟内容之间都要有一个空格

 

效果如下:

  • 列表内容

  • 列表内容

  • 列表内容

  •  

有序列表

  •  

语法:
数字加点

1.列表内容

2.列表内容

3.列表内容

 

注意:序号跟内容之间要有空格

效果如下:

1.列表内容
2.列表内容
3.列表内容

  •  

列表嵌套

  •  

上一级和下一级之间敲三个空格即可

  •  

一级无序列表内容

    • 二级无序列表内容

    • 二级无序列表内容

    • 二级无序列表内容

  •  

一级无序列表内容

    1. 二级有序列表内容

    2. 二级有序列表内容

    3. 二级有序列表内容

  1.  

一级有序列表内容

    • 二级无序列表内容

    • 二级无序列表内容

    • 二级无序列表内容

  1.  

一级有序列表内容

    1. 二级有序列表内容

    2. 二级有序列表内容

    3. 二级有序列表内容


之后是markdown中插入列表的几种方式。

八、表格

语法:

表头|表头|表头

---|:--:|---:

内容|内容|内容

内容|内容|内容

 

第二行分割表头和内容。

- 有一个就行,为了对齐,多加了几个

文字默认居左

-两边加:表示文字居中

-右边加:表示文字居右

注:原生的语法两边都要用 | 包起来。此处省略

效果如下:

姓名

技能

排行

刘备

大哥

关羽

二哥

张飞

三弟

九、代码

语法:
单行代码:代码之间分别用一个反引号包起来

    `代码内容`

代码块:代码之间分别用三个反引号包起来,且两边的反引号单独占一行

(```)

  代码...

  代码...

  代码...

(```)

注:为了防止转译,前后三个反引号处加了小括号,实际是没有的。这里只是用来演示,实际中去掉两边小括号即可。

示例:

单行代码

`create database hero;`

代码块

(```)

    function fun(){

         echo "这是一句非常牛逼的代码";

    }

    fun();

(```)

效果如下:

单行代码

create database hero;

代码块

function fun(){

  echo "这是一句非常牛逼的代码";

}

fun();

这是一些markdown的简单基础用法。

https://www.jianshu.com/p/191d1e21f7ed 这是对于有简单用法的介绍网站。

https://www.zybuluo.com/mdeditor 这是一个在线markdown编辑工具,不过在你第一次打开的时候就会出现我在文章开头插入的两张图片内容,界面被分为两个左边是你用markdown所书写的内容,右边就是你呈现出来的内容,里边很多用法可以都可以很明显的明白这些语法是怎么来进行使用的。

  本来想在文章末尾给大家分享一个markdown的工具,但是看了一些之后发现,还是我上边所发的那个CMD markdo编辑器(https://www.zybuluo.com/mdeditor)好用一些,是在线版的并且登陆账号之后数据可以同步,在不同地方都可以直接查看,很适合我这种新手使用。因为在你并没有完全熟悉markdown编辑之前还可以使用他在页面上部分所提供的工具栏来完成你的编辑。并且虽然为网页版但是他也是可以在离线模式下进行操作,等连接网络后将数据同步一次即可。并且现在很多文档编辑器,例如有道笔记,例如我们csdn的网页都内嵌有markdown的工具所以大家也没有必要一定要安装一个编辑器。

  因为昨天刚进行接触markdown工具,之后在使用后会给大家再详细介绍。