`

Markdown入门 - 基础语法介绍

阅读更多

 

本质

 

Markdown markdown 是文本,写完之后保存成txt文件,需要用引擎(markdown引擎是用markdown写的)来转化成html才能在浏览器显示。比如官方页面:
推荐一个markdown编辑器,叫MarkdownPad(http://markdownpad.com/)。提供实时预览和常用的菜单操作。
基本语法

 

标题:

markdown支持两种风格语法Setext 和 atx
Setext 如下>>
H1: Hello
      =

H2: Hello
      -

无论“=” 和‘-’多少个,作用和一个是一样的

atx 如下>>

# This is an H1
## This is an H2
...
"#"个数表示标题级别,也可以将标签闭合起来,比如
# This is an H1 ###

左边的"#"个数决定文本的级别,右侧可以任意多个

块级引用:

markdown用">"来开始一段被引用的文本,比如
> This is a markdown text block
> Lazy dog jump over the grey fox
> Lazy dog jump over the grey fox
> Lazy dog jump over the grey fox
块级引用支持懒人写法,只在段落的第一行写一个">", 比如
> This is a markdown text block
   Lazy dog jump over the grey fox
   Lazy dog jump over the grey fox
   Lazy dog jump over the grey fox
块级引用支持引用嵌套,左边“>”的个数表示嵌套的层数,比如

>This is a markdown text block
>> This is a markdown text block
块级引用中支持其他markdown标签,包括标题,列表,代码块

列表:

markdown支持有序和无序两种列表。有序的只支持数字序号,无序的支持"*", "+", "-"。在markdown里写有序刘表的序号是无意义的,它会重新排序,而无序列表不管用哪种符号,显示出来的多是黑点。比如

有序>>

1. First
1. Second
4. Third 
显示出来的是
1. First
2. Second
3. Third 
如果不想让markdown排序,则可以加反斜杠,比如
1\. First
1\. Second
4\. Third 

无序>>

+ First
+ Second
+ Third 

如果要在列表中用块级引用,则需要">"前回车换行,比如

+ First
> block goes here
+ Second
+ Third 

代码块:

markdown中代码块,可以简单的用4个空格或者1个Tab缩进, 比如

        sdfasdfas
            asdfasd
        asdfasdf>
        <div class="asdfas">
            &nbsp; 2004 Foo Corpration
        </div>
在遇到第一个缩进的行时,代码块自动终止。在代码块中所有的特殊字符,比如< > &等都会转化成html实体 (&lt; &gt; &amp;)
如果需要在行内使用代码风格,则可以用"`"包围,即键盘上波浪线那个键。

水平分割线:

可以用连续的三个以上"*"或者"-",“*”符号之间最多保3个空格,“-”之间最多2个

链接:

markdown支持两种风格:行内,引用

行内>>

This is a [Link](http://g.cn "谷歌")
方括号中的是链接文本,括号中的两个参数,第一个是链接地址href,第二个是title,两者之间用空格隔开。

引用>>

This [LinkName][id] referrence-style link

[id]: http://g.cn 
"谷歌"

这里的"id"相当于一个标识符,对应这个链接的信息,可以为任意字符(包括数字)。标识符用"[]"包围,后面跟链接的href, title。href和title之间用空格或者换行分开,title必须用双引号包围。标识符部分可以写在页面任意地方,不需要紧随[LinkName]。

标识符不区分大小写,比如
[link][a]
[link][A]都将引用
[a] http://g.cn "谷歌"
如过有多个引用值,则取最后一个
比如
[a] http://g.cn "谷歌"
[A] http://baidu.com "百度"

链接将指向最后一个定义的地址。

如果标识符忘了写,则LinkName将作为标识符,比如
[Google][]
那么写链接信息时需要
[Google]: http://g.cn "谷歌"

简单的链接可以用"<>"包围,比如
<http://g.cn>,它将产生一个<a href='http://g.cn'>http://g.cn</a>的链接

强调:

markdown中强调也有加粗(B)和倾斜(I),有两种方式。
倾斜用“*”或者“_”包围,加粗用“**”或者“__”

图片:

类似链接也有两种风格:行内,引用

行内>>
![图片alt文本](https://www.google.com.hk/images/nav_logo107.png "图片title")
引用>>
![图片alt文本][id]
这里的id标志符写法同链接的写法
[id]: https://www.google.com.hk/images/nav_logo107.png "图片title"


 

分享到:
评论

相关推荐

Global site tag (gtag.js) - Google Analytics