首页 > 代码库 > markdown基础

markdown基础

markdown 基础

介绍

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

说的简单一点,markdown其实就是一种简单的文本,与普通的文本文件 (txt文件)不同的是,支持一些特殊的符号,通过特殊的符号来表示不同的语义,并且给予不同的样式。同时普通的文本文件后缀是.txt,而markdown文件的后缀是.md。

宗旨和特点

markdown 实现的宗旨是[易读易写]。方便书写和阅读,通过特殊的符号实现一些基础的样式,而不同的符号也代表了不同的语义,例如#表示一级标题,##则表示二级标题。

同时,markdown文件还可以兼容一些html标签,让markdown书写的范围应用更广。

在markdown文件中,一些特殊字符会被转换,所以想要在markdown中输出一些特殊字符需要使用实体字符才能输出成。

例如想要输出? 必须使用实体字符。

http://tool.xker.com/htmlchar.php

markdown常用语法

标题

在markdown中,存在不同级别的标题,类似于我们在作文中的标题,共有六级标题。 每一级标题通过#来表示,例如一级标题是一个#,二级标题就是两个#,以此类推。

区块引用

在markdown中,如果想要表示区块引用,可以使用>来表示,例如,表示某人说的一句话。

李白:安能使我摧眉折腰事权贵,使我不得开心颜

同样,我们的引用也可以是多行的,那么就可以在>一行的后面输入回车,然后继续来书写内容,如下:

世上本无路,走的人多了,也就有了路 * -- 鲁迅 * 鲁迅(1881年9月25日-1936年10月19日),原名周樟寿,后改名周树人,字豫山,后改豫才,“鲁迅”是他1918年发表《狂人日记》时所用的笔名,也是他影响最为广泛的笔名,浙江绍兴人。著名文学家、思想家,五四新文化运动的重要参与者,中国现代文学的奠基人。毛主席曾评价:“鲁迅的方向,就是中华民族新文化的方向。

在区块引用中,也可以使用其他的markdown语法,例如标题:

兄弟连H5全栈开发课程
  1. HTML5 + css3
  2. JavaScript
  3. jQuery
  4. 响应式网页设计
  5. Less and Sass
  6. Vue.js
  7. Node.js
  8. Express
  9. ......

列表

在markdown语法中,支持列表的语法,而列表通常情况下分为无序列表和有序列表。

无序列表

markdown中,想要实现无序列表的样式,可以在每一项选项前添加*或者+或者-,如下:

  • 白日依山尽
  • 黄河入海流
  • 欲穷千里目
  • 更上一层楼

当然也可以使用 + 或者 - 来实现无序列表

  • 锄禾日当午
  • 汗滴禾下土
  • 谁知盘中餐
  • 粒粒皆辛苦

有序列表

markdown中,想要实现有序列表的样式,可以在每一个选项前面使用数字和英文的点.

h5学习顺序
  1. html
  2. css
  3. JavaScript

代码区块

和程序相关的写作或是标签语言原始码通常会有已经排版好的代码区块,通常这些区块我们并不希望它以一般段落文件的方式去排版,而是照原来的样子显示,Markdown会用pre和code标签来把代码区块包起来。

要在 Markdown 中建立代码区块很简单,只要简单地缩进 4 个空格或是 1 个制表符就可以,例如,下面的输入:

function show () {
    alert(‘hello,world‘)
}
show()

在上面的内容的前面,输出四个空格或者一个制表符(一下tab键) ,就可以实现代码段的样式。

分割线

可以在一行中使用三个以上的星号,减号,下划线来建立一个分割线,行内不能有其他内容,但是可以在其中插入空格 ,下面的几种写法都可以创建分割线:

***
* * * 
___
_ _ _
________

链接

在markdown中表示链接,可以按照下面的语法来实现。

首先,链接文字要使用[] 来表示链接的名字,而在链接的网址则在后面使用()来表示。 如下:

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

效果如下:

百度

强调

在正常的文本编辑中,经常会碰到需要强调的内容,那么可以使用星号(*)和下划线(_)来表示需要强调的内容。

如下:

*hello,world*

效果如下: hello,world

如果用两个星号或者下划线,则字体会加粗,强调级别更高。

如下:

**hello,world**

效果如下:

hello,world

代码

如果要在文档内容中表示代码,则可以使用反引号(``)将内容包裹起来。 如下:

`var a = "hello,world";
 alert(a)
`

效果如下: var a = "hello,world" alert(a)

图片

在日常的编辑中,如果需要加入图片,可以采用下面的方式:

![图片加载失败时替代文字](图片地址 "图片的提示文字")

![郁金香](./Tulips.jpg "郁金香")

效果如下: 技术分享

反斜杠的作用

在markdown中,存在一些特殊的字符,具有一定的语法意义,例如#表示标题等等,那么在文字编辑的时候想要输出这些特殊的字符不能够直接输出,而是应该使用\转义。

如下:

\#

效果如下: #

这样就能够在正常的编辑中输出这些特殊的字符。

markdown基础