Markdown简明教程


小组需要使用Markdown来记录,所以整理了一个简明教程给大家浏览~

1. 标题

  语法:# + 空格 + 标题文字

  标题分为1-6级,增加一个"#"号,标题增加一级,示例如下:

2.强调

l  粗体

  语法:** + 文本 + **

l  斜体

  语法:* + 文本 + *

l  分割线

  语法:***(单独一行输入三个星号)或者---(单独一行输入三个减号)

效果如下:

(注意:星号与文本之间无空格)

3. 引用

  语法:> + 空格 +引用文本

效果如下:

4. 列表

l  有序列表

  语法:数字+英文句号+空格+文本

  (eg:1. 我是文本)

l  无序列表

  语法:符号+空格+文本

  (此处符号可以是星号、加号和减号)

效果如下:

5. 链接

l  行内

  语法:[显示的链接名](链接url地址)

  eg: 这是一个[链接](http://baidu.com)

l  参考

  语法:[显示的链接名](链接id)

  为链接定一个名称,之后在文件的其他地方定义该链接的内容

  eg:这是链接1 [Google][1] ,这是链接2[Yahoo][2] .

  [1]: http://google.com/ "Google"

  [2]: http://search.yahoo.com/ "Yahoo Search"

l  html标签

  由于markdown支持html语法,所以也可以用html的<a>标签

  语法:<a  href=“链接url地址”>

  eg:<a  href="http://baidu.com">链接名</a>

效果如下:

 

6. 图片

l  行内

  语法:![代替文本](图片地址路径 "title")

  eg:  ![代替文本](/path/to/img.jpg "Title")

l  参考

  语法:![代替文本](图片id),在文件的其他地方定义该图片id的路径

  eg:  ![代替文本][id]

   [id]: /path/to/img.jpg "Title"

l  html标签

  由于markdown支持html语法,所以也可以用html的<img>标签,个人认为相对方 便,可以直接调整大小

  语法:<img  src=“图片地址路径” title="标题"  width="200px" height="200px“>

  eg:<img  src=" /path/to/img.jpg"  width="100px">

效果如下:

7. 代码

l  代码区段

  语法:反引号 ` 标记代码区段

  区段内的 &、< 和 > 都会被自动的转换成 HTML 实体

l  代码区块

  语法:每行都缩进 4 个空格或是一个 tab

  如果要建立一个已经格式化好的代码区块,只要每行都缩进 4 个空格或是一个 tab 就可以了,而 &、< 和 > 也一样会自动转成 HTML 实体。

效果如下:

8.反斜杠

  Markdown 可以利用反斜杠来插入一些在语法中有其它意义的符号

  语法: + 在语法中有意义的符号

注:

1.markdown语法兼容 HTML

Markdown 语法的目标是:成为一种适用于网络的书写语言,它的语法种类只对应 HTML 标记的一小部分(只涵盖纯文本)。HTML 是一种发布的格式,Markdown 是一种书写的格式。

不在 Markdown 涵盖范围之内的标签,都可以直接在文档里面用 HTML 撰写。不需要额外标注这是 HTML 或是 Markdown;只要直接加标签就可以了。

要制约的只有一些 HTML 区块元素――比如 <div>、<table>、<pre>、<p> 等标签,必须在前后加上空行与其它内容区隔开,还要求它们的开始标签与结尾标签不能用制表符或空格来缩进。

2.本文档提供常用语法使用,推荐一个详细教程:http://www.appinn.com/markdown/index.html

原文地址:https://www.cnblogs.com/evaxtt/p/9585747.html