Markdown

作者: 王执姬 | 来源:发表于2018-03-13 01:00 被阅读0次

为什么要使用Markdown


易读易写

1.纯键盘操作,效率高

2.纯文本,兼容性强

Markdown基本语法


Markdown语法的特点:全部由符号组成

1.标题

类Setext

= (最高阶标题)

- (第二阶标题)

这是H1

=============

这是H2

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

类Atx

在行首插入 1 到 6 个 # ,对应到标题 1 到 6 阶。

# 这是 H1

## 这是 H2

如果为了美观,也可以选择性“闭合”。

# 这是 H1 #

而且文字后面的#个数并不影响文字大小。

## 这是 H2 ###

2.列表

无序列表

使用星号、加号或是减号作为列表标记,以星号为例,如:

*  Red

*  Green

*  Blue

有序列表

使用数字接着一个英文句点:

1.  Bird

2.  McHale

3.  Parish

很重要的一点是,在列表标记上使用的数字并不会影响输出的结果

3.分隔线

在一行中用三个以上的星号、减号、底线可以建立一个分隔线(在星号或是减号中间可以插入空格,但行内不能有其他内容)

* * *

***

- - -

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

4.引用

在整个段落第一行前加上反尖括号(>),如:

>这是引用

5.代码引用

用反引号(`)把所引用的代码包起来,如:

Use the `printf()` function.

其效果等同于:

<p>Use the <code>printf()</code> function.</p>

6.强调

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

粗体

用两个 * 或 _ 包起来的话,则会被转成 <strong>

*single asterisks*

_single underscores_

斜体

被 * 或 _ 包围的字词会被转成用 <em> 标签包围

**double asterisks**

__double underscores__

7.表格

利用制表符制作表格

图片来源见参考资料

8.链接

行内式

在方块括号后面紧接着圆括号并插入网址链接即可(如果还想要加上链接的 title 文字,只要在网址后面,用双引号把 title 文字包起来即可)例如:

This is [an example](http://example.com/ "Title") inline link.

参考式

在链接文字的括号后面再接上另一个方括号

然后在第二个方括号里面要填入用以辨识链接的标记:

This is [an example][id] reference-style link.

接着,就可以在文件的任意处,把这个标记的链接内容定义出来:

[id]: http://example.com/  "Optional Title Here"

9.图片

行内式

一个叹号 !

接着一个方括号,里面放上图片的替代文字

接着一个普通括号,里面放上图片的网址

![Alt text](/path/to/img.jpg)

最后还可以用引号包住并加上 选择性的 'title' 文字。

![Alt text](/path/to/img.jpg "Optional title")

参考式

图片的参考式和链接参考式大致方法一样:

![Alt text][id]

[id]: url/to/image  "Optional title attribute"

到目前为止, Markdown 还没有办法指定图片的宽高,如果你需要的话,你可以使用普通的 <img> 标签。

10.自动链接

用尖括号括起来

<http://www.baidu.com/>

11.特殊符号

如何插入一些在语法中有其它意义的符号呢?Markdown 支持在以下这些符号前面加上反斜杠来帮助插入普通的符号:

图片来源见参考资料

Markdown 的格式语法只涵盖纯文本可以涵盖的范围。

不在 Markdown 涵盖范围之内的标签,都可以直接在文档里面用 HTML 撰写。不需要额外标注这是 HTML 或是 Markdown;只要直接加标签就可以了。

参考资料


【知乎】为什么要用Markdown写作?

【简书】献给写作者的 Markdown 新手指南

Markdown语法说明

收获


第一次接触Markdown是卓越女生计划纳新作业题,从百度上搜索的时候就看到各种教程中都大肆赞美Markdown容易排版,效率高等优点。

但我当时并不这样认为。

我用手机完成作业,我觉得打这些符号很麻烦,完全没有在word里用鼠标选中要操作的文段,再点字号或者加粗倾斜等操作来的方便。

认为一个东西有用是对它产生兴趣的必要条件之一,显然,通过了面试之后我再也没用过Markdown,即使在简书上写总结,也用的是富文本模式。

但是今天,读完Markdown语法说明以后,我也深深赞同了各种MD语法教程对其的赞美。

对于生疏的外行人,把这些符号打出来确实不如鼠标点点方便,但是对于一个熟练操作键盘的程序员,MD无疑是一种优秀的、方便的标记语言。

第一次使用MD语法编写文档,我便觉得它和HTML有很多相似之处,知道今天我读到了“不在 Markdown 涵盖范围之内的标签,都可以直接在文档里面用 HTML 撰写”,我更进一步的体会到了他的优点。

emmm……总之我已经把简书的编辑模式切换成了Markdown,这篇文章或许会是我用富文本模式写的最后一篇文章~~O(∩_∩)O~~

不好用还是不会用,这是个值得思考的问题。

相关文章

网友评论

      本文标题:Markdown

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