美文网首页
Markdown入门

Markdown入门

作者: 小小在流浪 | 来源:发表于2018-04-16 12:19 被阅读0次

标题

Markdown支出两种标题的语法。

一、在标题的底部紧跟着=- ,任何数量的 =-都可以有效果。
例如:

这是一个H1的标题
=============
这是一个H2的标题
------------------

效果:

这是一个H1的标

这是一个H2的标题

二、 在文字开头插入 1 到 6 个 # ,对应到标题 1 到 6 阶,为了美观,你可以在行尾加上 #,标题 1 到 6 阶取决于开头的#数量,而行尾的 # 数量也不用和开头一样,效果都是一样的。
例如:

 (方法一)
#  这是H1的标题     
##  这是H2的标题  
######  这是H6的标题
(方法二)
#  这是H1的标题 #   
##  这是H2的标题  ##   
######  这是H6的标题  ###### 

效果:

这是H1的标题

这是H2的标题

这是H6的标题

代码区块

我一直很喜欢一句话,Talk is cheap. Show me the code,所以说一篇技术性文章缺少不了代码区块,Markdown 中建立代码区块很简单,只要简单地缩进 4 个空格或是 1 个制表符就可以。一个代码区块会一直持续到没有缩进的那一行(或是文件结尾)。注意:在代码区块中,一般的 Markdown 语法不会被转换,eg:*就只是*而已。
例如:

    这是一行普普通通的文字。

        这是一个代码区块 * 1
    这是末尾行

效果:

这是一行普普通通的文字。

    这是一个代码区块 * 1
这是末尾行

分割线

一行中使用3个以上的*-_来建立一个分隔线,行内不能有其他东西。但是可以*-_中间插入空格。
例如:

*** 
****
* * * 
---
----
- - -
___
____
_ _ _

效果:


(为了美观。只取其中一条的效果)


区块引用

一、在每行的最前面加上 > 即可。
例如:

>  这是一个区块引用

效果:

这是一个区块引用

二、 如果你觉得在整个段落的每行最前面加上>,数量太多的时候,Markdown允许你只在整个段落的第一行前面加上>
例如:

> 这是第一行
  这是第二行
  这是最后一行

效果:

这是第一行
这是第二行
这是最后一行

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

>  这是第一行
> > 这是第二行
> > > 这是第三行
>
> 这是最后一行

效果:

这是第一行

这是第二行

这是第三行

这是最后一行

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

    > ## 这是一个标题。
    >
    > 1.   这是第一行列表项。
    > 3.   这是第二行列表项。
    > 
    > 给出一些例子代码:
    > [简书](https://www.jianshu.com)
    >    extension UIColor{}
    

效果:

这是一个标题。

  1. 这是第一行列表项。
  2. 这是第二行列表项。

给出一些例子代码:
简书
extension UIColor{}


列表

项目列表,Markdown 支持有序列表和无序列表。
一、 无序列表使用*+-作为列表标记,效果都是一样的,Markdown 会让输出的列表数字按用户输入的输出。
例如:

 (写法一)
*   方法一
*   方法二    
*   方法三
(写法二)
+   方法一
+   方法二
+   方法三
(写法三)
-   方法一
-   方法二
-   方法三

效果:

  • 方法一 (用的是*)
  • 方法二(用的是+)
  • 方法三 (用的是-)

二、有序列表则使用数字接着一个英文句点,你可以完全不用在意前面数字的正确性,输出的列表数字,Markdown 会按照当前段位的起始列表数字依次递增。
例如:

(任意随机数)
20.  方法一 (起始20)
1.  方法二
8.  方法三

效果:

  1. 方法一 (起始20)
  2. 方法二
  3. 方法三

三、 列表项目可以包含多个段落,每个项目下的段落都必须缩进 4 个空格或是 1 个制表符。为了code工整,建议每行缩进,看起来会看好很多,如果你没有这样子做,Markdown也会在输出的时候帮您实现缩进的。
例如:

*  我就是我,不一样的烟火。

    我喜欢看动漫,eg:火影、海贼、妖精的尾巴等等,

*  我也喜欢打王者,可是很菜。

效果:

  • 我就是我,不一样的烟火。

    我喜欢看动漫,eg:火影、海贼、妖精的尾巴等等,

  • 我也喜欢打王者,可是很菜。

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

*   这是一个带区块引用的列表项目

    > 这是一个区块引用
    > 它被包含在列表里项目里面.

效果:

  • 这是一个带区块引用的列表项目

    这是一个区块引用
    它被包含在列表里项目里面.

五、 如果要放代码区块的话,该区块就需要缩进两次,也就是 8 个空格或是 2 个制表符:
例如:

* 一列表项包含一个列表区块:

        <我是代码区块>

效果:

  • 一列表项包含一个列表区块:

      <我是代码区块>
    

六、异常数据处理
例如:
项目列表很可能会不小心产生,像是下面这样的写法:

2018. 4 月 12 日,天气晴。

效果:

  1. 4 月 12 日,天气晴。

换句话说,也就是在行首出现数字-句点-空白,要避免这样的状况,你可以在句点前面加上\
例如:

2018\. 4 月 12 日,天气晴。

效果:

2018. 4 月 12 日,天气晴。


代码

一、如果要标记一小段行内代码,你可以用`把它包起来就行。
例如:

`这是一段代码`

效果:

这是一段代码

二、如果要在代码区段内插入`,你可以在代码片段的起始跟末端分别插入两个`反引号。
例如:

``这行里面有个(`)符号哟。``

效果:

这行里面有个(`)符号哟。

三、代码区段的起始和结束端都可以放入一个空白,起始端后面一个,结束端前面一个,这样你就可以在区段的一开始就插入```:
例如:

这一行里面有个特殊的字:`` `龘` ``,不知道你们会不会读哦。

效果:

这一行里面有个特殊的字:`龘`,不知道你们会不会读哦。



强调

Markdown 使用*_作为标记强调字词的符号。
一、文字前后紧跟着相同的*或者_,使得文字有了简单的强调效果。
例如:

*Markdown*
_简书_

效果:

Markdown
简书

二、文字前后紧跟着相同的两个*_,使得文字有了strong的强调效果。
例如:

**Markdown**
__简书__

效果:

Markdown
简书

三、你可以随便用你喜欢的样式,唯一的限制是,你用什么符号开启标签,就要用什么符号结束,一行可以使用多个强调。
(注意:一段文字中,前后两个强调文字不要连续使用同一种符号,防止错误的识别)
例如:

这是*小小在流浪*在_简书_上发布__一篇__关于**Markdown**的文章。

效果:

这是小小在流浪简书上发布一篇关于Markdown的文章。

四、如果文字前后的*_两边都有空白的话,它们就只会被当成普通的符号。
例如:

这是* 小小在流浪*在简书上__ 发布 __一篇关于Markdown的文章。

效果:

这是* 小小在流浪*在简书上__发布 __一篇关于Markdown的文章。

五、如果要在文字前后直接插入普通的**,你可以在强调符号前面插入\
例如:

这是\*小小在流浪\*在简书上 发布一篇\__关于\__Markdown的文章。

效果:

这是*小小在流浪*在简书上 发布一篇__关于__Markdown的文章。


链接

Markdown 支持两种形式的链接语法: 行内式和参考式两种形式。
不管是哪一种,链接文字都是用[]来标记。
一、行内式的链接:只要在[]后面紧接着()并插入网址链接即可,如果你还想要加上链接的 title 文字,只要在网址后面,用""把 title 文字包起来即可。
例如:

这是小小在流浪在[简书](https://www.jianshu.com/u/3a19789f1337 "可选标题")的文章。

效果:

这是小小在流浪在简书的文章。

二、如果你是要链接到同样主机的资源,你可以使用相对路径。
例如:

点击[下载](/apps/)简书App。

效果:

点击下载简书App。

三、参考式链接:在[]里面加入用以辨识链接的标记文字或者ID即可。
例如:

这是小小在流浪在[简书]的文章。

接着,把这个标记的链接内容定义出来。
链接内容定义的格式为:

[标记]: 网址 "可选标题"

链接内容定义:

[简书]: https://www.jianshu.com "可选标题"

效果:

这是小小在流浪在简书的文章。

四、如果[]里面用以辨识链接的标记文字过于长的话,我们可以用另一个简短的标记进行替代,只需要在[]的后面再接着一个[],然后在第二个 []写入替代的标记。
例如:

这是小小在流浪在[简书][replaceId]的地址。

[replaceId]:https://www.jianshu.com/u/3a19789f1337

效果:

这是小小在流浪在简书的地址。


图片

Markdown 支持两种形式的图片语法: 行内式和参考式两种形式。
一、行内式格式:

![文字][图片路径]

例如:

![乔巴](https://img.haomeiwen.com/i5902884/4a0f7a0e8658bda3.jpg?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240)

效果:

乔巴

二、参考式格式:

![文字][标记]
[标记]: 网址  "可选标题"

例如:

![路飞][Luffy]

[Luffy]: https://timgsa.baidu.com/timg?image&quality=80&size=b9999_10000&sec=1523862255354&di=25ba1fe05978d577bd5c6c85e01d92e8&imgtype=0&src=http%3A%2F%2Fimg.m.club.pchome.net%2Fupload%2Fclub%2Fother%2F2008%2F8%2F9%2Fsmall%2Fpics_xcmjwxj_1218277987.jpg  "海贼王"

效果:

路飞路飞

脚注

格式:[^标记]
例如:

  这是一个链接到简书的脚注[^脚注]。
  
  [^脚注]: https://www.jianshu.com

效果:

这是一个链接到简书的脚注[1]


反斜杠

如果只想在Markdowm中插入普通的符号,只需要在插入的符号前面
插入\即可。
例如:

\\
\&
\*简书\*

效果:

\
&
*简书*


自动链接

格式:[网址]
例如:

这是一个自动链接<https://www.jianshu.com>

效果:

这是一个自动链接https://www.jianshu.com


  1. https://www.jianshu.com

相关文章

  • Markdown书写设置

    MarkDown入门请查看 : MarkDown入门 书写Markdown时,有时候需要单独标记某些字句的颜色、大...

  • 便签

    Markdown Markdown写作进阶:Pandoc入门浅谈

  • markdown入门

    markdown入门

  • Markdown 入门指南

    Markdown 入门指南 目录Markdown 语法的起源Markdown 语法的种类Markdown trad...

  • markdown的语法

    markdown的语法示例,具体看图Markdown——入门指南

  • 2018-08-29

    #Markdown快速入门 ##

  • Markdown语法

    参考:Markdown语法入门

  • Markdown学习指南

    献给写作者的 Markdown 新手指南 Markdown: Basics (快速入门) Markdown 语法说...

  • markdown语法

    参考链接 wowubuntu Markdown——入门指南 learning markdown guide(列表元...

  • Markdown语法

    1. Markdown 新手指南2. Markdown 快速入门3. Markdown 完整语法

网友评论

      本文标题:Markdown入门

      本文链接:https://www.haomeiwen.com/subject/tpvghftx.html