Skip to content

deardirks/Markdown

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

14 Commits
 
 
 
 

Repository files navigation

Markdown

什么是Markdown?

Markdown 是一种轻量级「标记语言」,它允许人们使用易读易写的纯文本格式编写文档,然后转换成格式丰富的HTML页面。 --维基百科
Markdown通常为程序员与专注于写作的群体所用。

不要被「标记语言」这个说法吓到,这一点也不难。它实际上是个非常简单、非常容易学习的语法。这个语法简单到每个人都可以在半天以内掌握。因此学习成本并不高,且一旦熟悉这种语法规则,会有一劳永逸的效果。应该是为数不多,你真的可以彻底学会的语言。

正如您在阅读的这份文档,它使用简单的符号标识不同的标题,将某些文字标记为粗体或者斜体,创建一个链接。是不是简单又实用呢?让写作变得更简单,我们不用再考虑如何排版,我们只要专心于写作就好了,这也是Markdown的宗旨!!!

目录


以下为整理归纳的语法。学完这些Markdown的基本使用已经不成问题。

分级标题

常言道:看书先看皮,看报先看题,标题可以使读者了解到文章的主要内容和主旨。

在Markdown当中设置标题,有两种方式:

第一种:通过在文字下方添加“=”和“-”,他们分别表示一级标题和二级标题。

这是一个一级标题
====================

这是一个二级标题
-------------------------------------

这是一个一级标题

这是一个二级标题

第二种:在文字开头加上 “#”,通过“#”数量表示几级标题。(一共只有1~6级标题,1级标题字体最大) 注意:为避免兼容性问题,#后面请保留一个空格再加上文字。

# 一级标题
## 二级标题
### 三级标题
#### 四级标题
##### 五级标题
###### 六级标题

一级标题

二级标题

三级标题

四级标题

五级标题
六级标题

区块引用

区块引用需要在被引用的文本前加上>符号。

>这是一个区块引用实例;

>也称为块注释(blockquote)

>     (当>和文字之间添加五个blank时,块注释的文字会有变化。)

这是一个区块引用实例;

也称为块注释(blockquote)

(当>和文字之间添加五个blank时,块注释的文字会有变化。)

Markdown 也允许你偷懒只在整个段落的第一行最前面加上 > :

> 业精于勤,
  荒于嬉;
  
> 行成于思,
  毁于随.

业精于勤, 荒于嬉;

行成于思, 毁于随.

读者可以试一试以下将会是何种效果?

> 业精于勤,
  荒于嬉;
            
  行成于思,(此处开头不添加>,并且上一行为空行)
  毁于随.

引用的多层嵌套

区块引用可以嵌套(例如:引用内的引用), 只要根据层次加上不同数量的 >:

>>> Hello World !

>> Github

> Markdown此处还应注意空行

Hello World !

Github

Markdown此处还应注意空行

引用其它要素

引用的区块内也可以使用其他的 Markdown 语法,包括标题、列表、代码区块等:

> - 天道酬勤
>
> - deardirks
>
> - 给出一些例子代码:
> ```markdown
>   return debug_backtrace();
> ```
  • 天道酬勤

  • deardirks

  • 给出一些例子代码:

  return debug_backtrace();

分隔线

你可以在一行中用三个以上的星号、减号、底线来建立一个分隔线, 行内不能有其他东西。你也可以在星号或是减号中间插入空格。下面每种写法都可以建立分隔线:

* * *

***

*****

- - -

---------------------------------------


强调

Markdown 使用星号*和底线_作为标记强调字词的符号。

斜体

*Markdown*

Markdown

粗体

**Markdown**

Markdown

删除线

~~Markdown~~

Markdown

列表

久而久之,你发现标题不适合做列表,于是用1. 第一点- 这一点来列表超级方便。

无序列表

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

- 我是一个无序列表
- 我是一个小圆点
    - 我还有二级列表哦
  • 我是一个无序列表
  • 我是一个小圆点
    • 我还有二级列表哦

有序列表

使用数字后面跟上英文的句号。(还要有空格)

1. 我是一个有序列表
2. 皮一下我还是很开心的~
  1. 我是一个有序列表
  2. 皮一下我还是很开心的~

包含引用的列表

如果要在列表项目内放进引用,那 > 就需要缩进:

*  **《赠别·其一》**  作者:*杜牧*:

  > 娉娉袅袅十三余,豆蔻梢头二月初。
  > 春风十里扬州路,卷上珠帘总不如。
  • 《赠别·其一》 作者:杜牧:

娉娉袅袅十三余,豆蔻梢头二月初。 春风十里扬州路,卷上珠帘总不如。

超链接

Markdown 支持两种形式的链接语法: 行内式和参考式两种形式, 行内式一般使用较多。

行内式

[]里写链接文字,()里写链接地址,()中的""中可以为链接指定title属性,title属性可加可不加。title属性的效果是鼠标悬停在链接上会出现指定的 title文字。 即[链接文字](链接地址 "链接标题") 这样的形式。链接地址与链接标题前有一个空格。

[Markdown Syntax](https://github.com/deardirks)
[Markdown Syntax](https://github.com/deardirks "deardirks")

Markdown Syntax

Markdown Syntax

参考式

参考式超链接一般用在学术论文上面, 或者另一种情况, 如果某一个链接在文章中多处使用, 那么使用引用的方式创建链接将非常好, 它可以让你对链接进行统一的管理。

参考式链接分为两部分, 文中的写法 [链接文字][链接标记],在文本的任意位置添加 [链接标记]:链接地址 "链接标题", 链接地址与链接标题前有一个空格。

全球最大的搜索引擎网站是[Google][1][1]:http://www.google.com "Google"

全球最大的搜索引擎网站是 Google

自动链接

Markdown 支持以比较简短的自动链接形式来处理网址和电子邮件信箱, 只要是用 <> 包起来, Markdown 就会自动把它转成链接。一般网址的链接文字就和链接地址一样, 例如:

<https://google.com/>

<deardirks@gmail.com>

https://google.com/

deardirks@gmail.com

锚点

锚点其实就是一个独立页面内的超链接,也就是链接本文档内部的某些元素, 实现当前页面中的跳转。比如我这里写下一个锚点, 点击**回到目录**, 就能跳转到目录。 在目录中点击锚点,又能跳转过来。还有下一节的注脚。这些根本上都是用锚点来实现的。

//首先,命名一个ID。
<span id = "jump">跳转到的位置</span>
//然后,建立一个跳转的连接。[说明文字](#jump)
//github上只需执行最后一个步骤。

About

Markdown Syntax 基础详解

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors