基本符号

  • *,-,+ 3个符号效果都一样,这3个符号被称为 Markdown符号
  • 空白行表示另起一个段落
  • `是表示inline代码,tab是用来标记 代码段,分别对应html的code,pre标签

换行

  • 单一段落( <p>) 用一个空白行
  • 连续两个空格 会变成一个 <br>
  • 连续3个符号,然后是空行,表示 hr横线

标题

  • 生成h1--h6,在文字前面加上 1--6个# 来实现
  • 文字加粗是通过 文字左右各两个符号

引用

  • 在第一行加上 “>”和一个空格,表示代码引用,还可以嵌套

列表

这个是markdown文件的主要表示方式,主题要点化

  • 使用*,+,-加上一个空格来表示
  • 可以支持嵌套
  • 有序列表用 数字+英文点+空格来表示
  • 列表内容很长,不需要手工输入换行符,css控制段落的宽度,会自动的缩放的

链接

  • 直接写 [锚文本](url "可选的title")
  • 引用 先定义 [ref_name]:url,然后在需要写入url的地方, 这样使用[锚文本][ref_name],通常的ref_name一般用数字表示,这样显得专业
  • 简写url:用尖括号包裹url 
    这样生成的url锚文本就是url本身

插入图片

  • 一行表示: ![alt_text](url "可选的title")
  • 引用表示法: ![alt_text][id],预先定义 [id]:url "可选title"
  • 直接使用<img>标签,这样可以指定图片的大小尺寸

特殊符号

  • 用\来转义,表示文本中的markdown符号
  • 可以在文本种直接使用html标签,但是要注意在使用的时候,前后加上空行
  • 文本前后各加一个符号,表示斜体

 

现在是我在学习Markdown时做的笔记。学完这些Markdown的基本使用已经不成问题。

 

 

1. 标题设置(让字体变大,和word的标题意思一样)
在Markdown当中设置标题,有两种方式:
第一种:通过在文字下方添加“=”和“-”,他们分别表示一级标题和二级标题。
第二种:在文字开头加上 “#”,通过“#”数量表示几级标题。(一共只有1~6级标题,1级标题字体最大)

2. 块注释(blockquote)
通过在文字开头添加“>”表示块注释。(当>和文字之间添加五个blank时,块注释的文字会有变化。)

3. 斜体
将需要设置为斜体的文字两端使用1个“*”或者“_”夹起来

4. 粗体
将需要设置为斜体的文字两端使用2个“*”或者“_”夹起来

5. 无序列表
在文字开头添加(*+, and -)实现无序列表。但是要注意在(*+, and -)和文字之间需要添加空格。(建议:一个文档中只是用一种无序列表的表示方式)

6. 有序列表
使用数字后面跟上句号。(还要有空格)

7. 链接(Links)
Markdown中有两种方式,实现链接,分别为内联方式和引用方式。

内联方式:This is an [example link](http://example.com/).
引用方式:
I get 10 times more traffic from [Google][1] than from [Yahoo][2] or [MSN][3]. 

[1]: http://google.com/ "Google" 
[2]: http://search.yahoo.com/ "Yahoo Search" 
[3]: http://search.msn.com/ "MSN Search"

 

8. 图片(Images)
图片的处理方式和链接的处理方式,非常的类似。
内联方式:![alt text](/path/to/img.jpg "Title")
引用方式:

![alt text][id]

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

9. 代码(HTML中所谓的Code)
实现方式有两种:
第一种:简单文字出现一个代码框。使用`<blockquote>`。(`不是单引号而是左上角的ESC下面~中的`)
第二种:大片文字需要实现代码框。使用Tab和四个空格。

10. 脚注(footnote)
实现方式如下:
hello[^hello]

[^hello]: hi

11. 下划线
在空白行下方添加三条“-”横线。(前面讲过在文字下方添加“-”,实现的2级标题)

 

 

 

References:

以上内容根据官方文档基本文档进行整理。http://daringfireball.net/projects/markdown/basics

Markdown官方网站:http://daringfireball.net/projects/markdown/

推荐一款在线的Markdown编辑器:https://stackedit.io/

markdown 简明语法
标签: