工作笔记

Markdown实战(一)初级语法

2019-09-23
阅读次数:

“Markdown 是一种轻量级标记语言,创始人为约翰·格鲁伯(John Gruber)。它允许人们“使用易读易写的纯文本格式编写文档,然后转换成有效的 XHTML(或者 HTML)文档”。这种语言吸收了很多在电子邮件中已有的纯文本标记的特性。”

标题

Markdown 支持两种标题的语法,类 Atx 和类 Setext 形式。

Atx(注意#后面有个空格)

# 一级标题
## 二级标题
### 三级标题

Setext(-与=数目任意,最好三个及以上,比较直观)

一级标题
======

二级标题
------

粗体和斜体

粗体

**这是粗体**

__这是粗体__

这是粗体

这是粗体

斜体

*这是斜体*

_这是斜体_

这是斜体

这是斜体

段落和换行

第一种写法,直接敲两个回车键即可

这是第一段

这是第二段

这是第一段

这是第二段

第二种写法,在写完一段后敲两个空格,然后回车写下一段

这是第二段  
这是第三段

这是第二段
这是第三段

第三种写法,在写完一段后用HTML的语法:<br />作为换行,然后写下一段

这是第三段<br />这是第四段

这是第三段
这是第四段

分隔线

可以在一行中用三个及以上的星号、减号、底线来建立分隔线,行内不能有除空格外的其他东西,注意莫被打脸。 (≖ ‿ ≖)✧

***
---
___
  • 正确写法





线


  • 打脸写法
    我是打脸的分隔线  
    ---
    

    打脸说明:文字和“—”没有空一行,写成了标题。

引言

我想只用一个 “>” 号来写一个多行的引用,所以在努力的多码些字,可是一番操作下来还是不够啊,那能怎么办,只能继续码啊,嗯嗯,现在好像够了~


还有一种写法就是每一行都用一个 “>” 号
这样写比较美观一点


另外一种就是嵌套引用,就像我一样,用两个“>”

列表

无序列表

无序列表可以在每行开头用星号、加号、减号来表示,也可以三者混合一起,推荐使用相同的字符,避免混乱。

  • 一朵百合花
  • 两朵百合花
  • 三朵百合花

有序列表

有序列表用数字接着一个英文句点来表示,数字可无序,但还是推荐使用1.、2.,避免混乱。

  1. 一朵百合花
  2. 两朵百合花
  3. 三朵百合花

代码

行内代码块

这是一行中的 代码块 ,用反引号` 来围住
这行代码中有(`)这个字符,这样的就要加两对反引号来围住

I am a `code`
I am a `` ` ``

段落代码块

  • 每一行都缩进 4 个空格或至少一个 Tab

      int main(){  
          return 0;  
      } 
    
  • 可以用三个反引号和语言名

int main(){
    return 0;
}
  • 在列表下的代码块要缩进两个Tab

      int main(){
          return 0;
      }
    

链接

网址链接

网址链接有两种形式:行内式、参考式。
不管是哪一种,链接文字都是用 [方括号] 来标记,双引号”“的title可写可不写。

  • 行内式
    [taylorzhou](https://taylorzhou.github.io)
    [taylorzhou](https://taylorzhou.github.io "taylorzhou")
    [taylorzhou](https://taylorzhou.github.io 'taylorzhou')
    
  • 参考式
    一般写法
[taylorzhou][1]

[1]:https://taylorzhou.github.io

隐式链接标记——可省略id,只需要[text]与下面[方括号]内容相同即可

[taylorzhou][]

[taylorzhou]:https://taylorzhou.github.io

这里的链接辨别标签可以有字母、数字、空白和标点符号,但是并不区分大小写,因此下面两个链接是一样的:

[text][a]
[text][A]

链接 title 可以用双引号、单引号、圆括号包起来,因此,下面这三种链接的定义都是相同:

[1]: https://taylorzhou.github.io  "taylorzhou"
[1]: https://taylorzhou.github.io  'taylorzhou'
[1]: https://taylorzhou.github.io  (taylorzhou)

图片链接

图片链接与上面的网址链接类似,同样有两种形式:行内式和参考式,只不过图片链接在前面加上一个感叹号!,在此不做累述。

  • 行内式
![Google](https://www.google.com/images/branding/googlelogo/2x/googlelogo_color_120x44dp.png)

Google

  • 参考式
![Google][1]
[1]: https://www.google.com/images/branding/googlelogo/2x/googlelogo_color_120x44dp.png "Google"

Google

指定图片宽高

  • Markdown 一般不支持指定图片的宽高,若要指定宽高可以使用普通的 <img> 标签
    <img src="./xxx.png" width = "100" height = "100" alt="title" align=center />
    

如果需要居中可以在外围包围div标签

<div  align="center">    
<img src="xxx.png" width = "100" height = "100" alt="title" align=center />
</div>
  • 使用支持指定图片大小的 Markdown 编辑器,如 Mou
    ![](xxx.png =100x100)
    

评论

目录