markdown基础语法

1.标题

标题格式:#+空格+标题内容,如# 标题

2.段落

用空白行创建段落,例如:

对泉能自诫,如镜静相邻。

最佳实践: 
  不要用空格或制表符(tabs)缩进段落。用&nbsp和全角空格缩进。

3.换行

两种方式,一种是在结尾处输入多个空格(>=2),然后按回车换行;另一种方式是用html标签</br>实现换行。

4.强调

两种强调,一种是加粗,一种是斜体。
1)加粗
语法 **加粗内容** 或 __加粗内容__ ,即用两个星号或两个下划线将强调内容包起来。建议用两个星号(**),不建议用两个下划线(__)
2) 斜体
一个或一个_。
如果想 加粗且斜体,用三个*号包起来(
号前面要有一个空格)。
This is really very important text.

5.引用

如果要引用,在段落前加一个>符号。

这句话我没说! –鲁迅

要结束引用,需要另起一段(加一个空行)。
可以包含多个段落。在段落的空白行添加一个>符号。

这句话我没说! –鲁迅
我说过。 –罗翔

引用可以嵌套。在要嵌套的段落 前添加一个>>符号。

罗翔老师说过:

啤酒饮料矿泉水,瓜子香烟大碗茶。 –罗翔

块元素可以包含一部分其他markdown格式的元素,如**,###等。

6.列表

有序列表
要创建有序列表,请在每个列表项前添加数字并紧跟一个英文句点。数字不必按数学顺序排列,但是列表应当以数字 1 起始。

注意:
1. 数字或-后要有一个空格,不然不识别
2. 创建子列表用四个空格  
2. 列表最好另起一段(即用空行隔开)
  1. 标题
    1. 子列表1
    2. 子列表2
  2. 段落

无序列表
要创建无序列表,请在每个列表项前面添加破折号 (-)、星号 (*) 或加号 (+) 。缩进一个或多个列表项可创建嵌套列表。

  • 列表1
  • 列表2
    • 子列表1
    • 子列表2
  • 列表3
  • 列表4

在列表中嵌套其他元素:

  1. 嵌套段落
    要在保留列表连续性的同时在列表中添加另一种元素,请将该元素缩进四个空格或一个制表符。

  2. 嵌套引用块

    罗翔老师说过

  3. 嵌套代码块
    代码块通常用四个空格或一个制表符缩进。当它们被放在列表中时,请将它们缩进8个空格或2个制表符。

     <html>
         <head>
             <title>Test</title>
         </head>
     </html>
    
  4. 嵌套图片

  5. 嵌套列表

    • abc
    • cde

7.代码

反引号
要将单词或短语表示为代码,请将其包裹在反引号(`)中。

注意:如果包裹的内容开始时有一个空格,对称的结束时也要有一个空格。
Markdown语法 HTML 预览效果
At the command promtp,type `nano` . At the command promtp,type<code>nano</code>. At the command promtp,type nano.

转义反引号
如果代码的单词或短语中包含一个或多个反引号,则可以通过将单词或短语包裹在反双引号( ``)中。

Markdown语法 HTML 预览效果
``Use `code` in your Markdown file.`` <code> Use `code` in your Markdown file.</code> Use `code ` in your Markdown file.

代码块
要创建代码块,2种方法:

  1. 将代码块的每一行缩进至少四个空格一个制表符

     <html>
         <head>
             <title>test</tile>
         </head>
     </html>
    
  2. 如果不用缩进的代码块,请使用围栏式代码块
    围栏代码块是用三个反引号(```)或三个波浪符号(~~~)。
    围栏代码块可以指定代码的类型(在第一个“`后+空格+代码类型),如下代码类型指定为html:

     <html>
         <head>
             <title>test</tile>
         </head>
     </html>
    

8.分隔线

要创建分隔线,在单独一行上使用至少三个星号(***)或至少三个破折号(—)或至少三个下划线(___),并且不能包含其他内容。

***  
---  
——————  
最佳实践:
为了兼容性,请在分隔线的前后均添加空白行。

----

9.链接

示例如下:

这是一个链接 **[Markdown语法](https://markdown.com.cn "最好的markdown教程")**。

效果:
这是一个链接 Markdown语法
其中,

  1. 方括号中是链接描述,圆括号中是链接url和链接title。
  2. 最好的markdown教程是可选的title,用于显示鼠标悬浮在链接上浮动框中的文字。
  3. 可以给链接加格式,如加粗、斜体、可以把方括号中的链接描述设置为显示为代码等。

使用尖括号可以方便的把URL或者email地址变成可点击的链接:

<https://markdown.com.cn>  
<fake@example.com>  

效果如下:
https://markdown.com.cn
fake@example.com

引用类型链接(锚点)
引用样式链接是一种特殊的链接,它使URL在Markdown中更易于显示和阅读。

例一

语法:[描述](#id)  

例子:  
<h3 id=_link_click_group>触发点 </h3>

[点击跳到链接一](#_link_1st)、[点击跳到链接二](#_link_2nd)、[点击跳到链接三](#_link_3rd)、脚注[^1]

<a id=_link_1st>链接一</a>([回到触发点](#_link_click_group))
<a id=_link_2nd>链接二</a>([回到触发点](#_link_click_group))
<span id=_link_3rd>链接三</span>([回到触发点](#_link_click_group))

[1]: 我是注脚

效果:

点击跳到链接一点击跳到链接二点击跳到链接三
生成一个脚注1[1]
链接一回到触发点
链接二回到触发点
链接三回到触发点

例二
作为变量。变量的值不会显示在页面上。

这个链接用 3 作为网址变量 [Google][3]
这个链接用 runoob 作为网址变量 [Runoob][runoob]
然后在文档的结尾为变量赋值(网址)

  [3]: http://www.google.com/
  [runoob]: http://www.runoob.com/

效果:
这个链接用 3 作为网址变量 Baidu
这个链接用 runoob 作为网址变量 Runoob
然后在文档的结尾为变量赋值(网址)

10.链接

要添加图像,请使用感叹号 (!), 然后在方括号增加替代文本,图片链接放在圆括号里,括号里的链接后可以增加一个可选的图片标题文本。

插入图片Markdown语法代码:![图片alt](图片链接 "图片title")

对应的HTML代码:<img src="图片链接" alt="图片alt" title="图片title">

11.转义字符

要显示原本用于格式化 Markdown 文档的字符,请在字符前面添加反斜杠字符\

\* Without the backslash, this would be a bullet in an unordered list.

渲染效果如下:
* Without the backslash, this would be a bullet in an unordered list.

12.内嵌HTML标签

对于 Markdown 涵盖范围之外的标签,都可以直接在文件里面用 HTML 本身。如需使用 HTML,不需要额外标注这是 HTML 或是 Markdown,只需 HTML 标签添加到 Markdown 文本中即可。

HTML 用法最佳实践:  

出于安全原因,并非所有 Markdown 应用程序都支持在 Markdown 文档中添加 HTML。如有疑问,请查看相应 Markdown 应用程序的手册。某些应用程序只支持 HTML 标签的子集。

对于 HTML 的块级元素 <div>、<table>、<pre> 和 <p>,请在其前后使用空行(blank lines)与其它内容进行分隔。尽量不要使用制表符(tabs)或空格(spaces)对 HTML 标签做缩进,否则将影响格式。

在 HTML 块级标签内不能使用 Markdown 语法。例如 <p>italic and **bold**</p> 将不起作用。

  1. 这是脚注的内容 ↩︎

原文地址:http://www.cnblogs.com/enjoyable/p/16801629.html

1. 本站所有资源来源于用户上传和网络,如有侵权请邮件联系站长! 2. 分享目的仅供大家学习和交流,请务用于商业用途! 3. 如果你也有好源码或者教程,可以到用户中心发布,分享有积分奖励和额外收入! 4. 本站提供的源码、模板、插件等等其他资源,都不包含技术服务请大家谅解! 5. 如有链接无法下载、失效或广告,请联系管理员处理! 6. 本站资源售价只是赞助,收取费用仅维持本站的日常运营所需! 7. 如遇到加密压缩包,默认解压密码为"gltf",如遇到无法解压的请联系管理员! 8. 因为资源和程序源码均为可复制品,所以不支持任何理由的退款兑现,请斟酌后支付下载 声明:如果标题没有注明"已测试"或者"测试可用"等字样的资源源码均未经过站长测试.特别注意没有标注的源码不保证任何可用性