markdown语法和心得

著作权归罪歌moecopilot本人所有。商业转载请联系作者 QQ 1993713026 获得授权,非商业转载请注明出处。
Moecopilot is the original author. Please give credit to the original author when you use it elsewhere.

在这篇文章里我会总结一下markdown的语法和心得

因为markdown真的是太好用了!!!!

需要注意的有以下几点
(建议先了解md语言之后再阅读,但我不想把此条放在后面……有必要放在最前面自省!)欲阅markdown语法库请往下翻跳过此标签。
  1. 嵌套性语句如 **[加粗]** <font color = 颜色 >[p]</font> 的休止一定要加上。有时的 </font> 忘记就会造成之后整片文章的颜色错误。
  2. markdown的大多数标记后需要加空格,如 #标题 这样的语句在编辑器里可以解析,但是在博客里就会显示为纯文字“#标题”而不是大标题。
  3. markdown允许内嵌HTML语法,一些原生markdown没有的功能也就可以写出来啦。比如可用 <font color = 颜色 >[p]</font> 来改变词语或整个段落的颜色。
  4. 换行可以用 <br/> ,不过我推荐使用md标准语法:“两个空格加回车”。
  5. 但是特殊字符的书写问题使得我们有时还是不习惯用HTML的行文来写,比如 <& ,< 符号用于起始标签,& 符号则用于标记 HTML 实体,如果你在HTML标签里只是想要显示这些字符的原型,你必须要使用实体的形式,像是 &lt;&amp; ,而如果用markdown的语法来行文,就不需要把所有要显示的<写为 &lt; 了,编辑器会自动底层转换为实体字符。
    所以你如果要在文档中插入一个版权符号 ©,你可以这样写: &copy; 也可以写 ©
    若你写: AT&T ,编译器会将它自动转为: AT&amp;T
    类似的状况也会发生在 < 符号上,因为 Markdown 允许兼容HTML,如果你是把 < 符号作为 HTML 标签的定界符使用,那 Markdown 也不会对它做任何转换,但是如果你写: 4 < 5 ,编译器会将它自动转为: 4 &lt; 5

Markdown 语法库

为什么要学习markdown语法?当然本萌新可能会总结得不全面,我把大佬的总结放上来吧……原文点击这里

在介绍其好处前,先说说Word这类富文本编辑器的好处:学习成本低,因为所见即所得。正因为其所见即所得的特性,所以只要是个识字的,会用拼音或五笔的,都会用Word,只要不是宏之类的。但是,不能因为其足够小白就可以忽略其毛病:

  • 臃肿 ——打开这个软件本身就需要耗费一些时间,更不用提文档较大时

  • 兼容性问题 ——不同版本的Word之间的兼容性都有点问题,更不用提其他文本编辑器了(一打开,全乱了),因为与微软的战略合作关系,WPS对Word文档兼容性最好,但也会出现用WPS能打开,用Word打不开的情况。

  • 容易崩溃 ——难道是是盗版的问题么?而且奔溃后,数据不一定能找回。

  • 没有版本控制 ——了解Git之后,觉得这个东西实在是太神奇了,不愧时光机的称号,只要你的使用习惯好,你可以知道你之前写了什么,你可以回退到任何一个保存过的版本,能不能将其应用到码字上呢?反正Word很难做到版本控制。

  • 你是关注文字还是排版 ——上大学时,做课程设计和实习报告,被打回来多因为一个问题:格式问题。因为大家内容都差不多,主要工作就是各种整格式,那时算是学会怎么去掉页眉的横线、怎么添加分页符、怎么插目录……但这些是重点么?难道不应该更多地关注内容?

Markdown的好处:

  • 学习成本低 ——身为一个轻量级的标记语言,Markdown拥有较少的标记符号,经常用到的就更少了,而且非常简单。

  • 任何文本编辑器都可以打开 ——Markdown文档实际上就是纯文本(plain text)格式,只要是个文本编辑器都可以打开,只不过支持Markdown语法的编辑器会将其渲染成相应格式,由于其语法足够简单,即使用不支持Markdown的编辑器打开,你也能看懂。

  • 格式转换方便 ——不少Markdown编辑器支持将文档转为pdf、docx、html等,你也可以使用具有瑞士军刀之称的Pandoc轻松将Markdown文档转为其他格式。

  • 你可以更多地关注内容 ——用富文本编辑器编辑文档的话,你的精力往往过多分散到排版上,有的人甚至逐句调整格式,学会Markdown的话,你的注意力又会重新转移到内容上来
    像记事本一样的速度 ——在Windows上办公时,我常常想,如果用记事本码字就好了,因为其打开速度实在是太快了。但记事本里的文字是没有格式的,体验很差,Markdown格式文档完美继承其速度,又添加了优美的格式。

  • 利用Github做版本控制 ——Github不仅仅可以用来托管代码,还可以用来托管文章,而且Github文档默认是Markdown格式的。另外,你还可以利用GitHub与Gitbook写电子书。

作者:习吾学
链接:https://www.jianshu.com/p/27d009f3c986
來源:简书
著作权归作者所有。商业转载请联系作者获得授权,非商业转载请注明出处。

其实markdown的语法也没多少。甚至边写边问度娘或谷哥都可以……

标题 Title

Markdown 支持两种标题的语法,类 Setext 和类 atx 形式。
类 Setext 形式是用底线的形式,利用 = (最高阶标题)和 - (第二阶标题),例如:

This is an H1
=============

This is an H2
-------------

显示为

This is an H1

This is an H2

任何数量的 = 和 - 都可以有效果。

类 Atx 形式则是在行首插入 1 到 6 个 # ,对应到标题 1 到 6 阶,例如:

# 这是 标题1  

## 这是 标题2 

###### 这是 标题6

显示为

这是 标题1

这是 标题2

这是 标题6

区块引用 Blockquotes

markdown中用>来行文:

> ## 这是一个标题。
> 
> 1.   列表项
> 2.   列表项
> 
> 给出一些例子代码:
> 
>     return shell_exec("echo $input | $markdown_script");
> 
> 还可以把区块嵌套成像这样:
> >第二层嵌套
> > >第三层嵌套
> > > >第四层嵌套

就能显示为

这是一个标题。

  1. 列表项
  2. 列表项

给出一些例子代码:

return shell_exec("echo $input | $markdown_script");

还可以把区块嵌套成像这样:

第二层嵌套

第三层嵌套

第四层嵌套

列表 list

Markdown 支持有序列表和无序列表。

无序列表使用星号、加号或是减号作为列表标记:

*   ass
*   we
*   can

+   deep
+   dark
+   fantasy

-   嘿
-   嘿
-   嘿

会显示为

当然,为了防止项目列表碰见句点和空格就形成,像下面这种写法:

1986. What a great season.

被显示成

  1. What a great season.

你可以在句点前面加上反斜杠。

1986\. What a great season.

1986. What a great season.

代码 Code

和程序相关的写作或是标签语言原始码通常会有已经排版好的代码区块,通常这些区块我们并不希望它以一般段落文件的方式去排版,而是照原来的样子显示,Markdown 可以用 <pre><code> 标签来把代码区块包起来,或者使用更简单的代码区段元素: 反单引号 ` ,用反单引号包起来的文字会保留其原有的实体。

代码区块或区段其实是最为常用的一种标记,比如本文就大面积的使用了代码区段。来来来给你们看一段

灰色的那些其实就都是代码区段。我用其来保持其内文本的原格式实体。

Markdown 支持两种形式的链接语法: 行内式参考式两种形式。
不管是哪一种,链接文字都是用 [方括号] 来标记。

行内式

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

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

[This link](http://example.net/) has no title attribute.

会显示为

This is an example inline link.

This link has no title attribute.

如果你是要链接到同样主机的资源,你可以使用相对路径:
See my [About](/about/index.html) page for details.

参考式

参考式的链接是在链接文字的括号后面再接上另一个方括号,而在第二个方括号里面要填入用以辨识链接的标记:
This is [an example][id] reference-style link.

接着,在文件的任意处,你可以把这个标记的链接内容定义出来:
[id]: http://example.com/ "Optional Title Here"

强调 Emphasize

Markdown 使用星号 * 和下滑线 _ 作为标记强调字词的符号,被 *_ 包围的字词会被转成用 <em> 标签包围,用两个 *_ 包起来的话,则会被转成 <strong> ,例如:

*single asterisks*

_single underscores_

**double asterisks**

__double underscores__

会显示为

single asterisks

single underscores

double asterisks

double underscores

你可以随便用你喜欢的样式,唯一的限制是,你用什么符号开启标签,就要用什么符号结束。

强调也可以直接插在文字中间:
un**frigging**believable
unfriggingbelievable

但是如果你的 *_ 两边都有空白的话,它们就只会被当成普通的符号。

如果要在文字前后直接插入普通的星号或底线,你可以用反斜线:

\*this text is surrounded by literal asterisks\*

图片

很明显地,要在纯文字应用中设计一个「自然」的语法来插入图片是有一定难度的。

Markdown 使用一种和链接很相似的语法来标记图片,同样也允许两种样式: 行内式和参考式。

行内式的图片语法看起来像是:

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

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

一个惊叹号 !
接着一个方括号,里面放上图片的替代文字
接着一个普通括号,里面放上图片的网址,最后还可以用引号包住并加上 选择性的 'title' 文字。
参考式的图片语法则长得像这样:

![Alt text][id]

「id」是图片参考的名称,图片参考的定义方式则和连结参考一样:

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

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

其它 Others

自动链接

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

<http://example.com/>

Markdown 会转为:

<a href="http://example.com/">http://example.com/</a>

反斜杠

Markdown 可以利用反斜杠来插入一些在语法中有其它意义的符号,例如:如果你想要用星号加在文字旁边的方式来做出强调效果(但不用 标签),你可以在星号的前面加上反斜杠:

\*literal asterisks\*

Markdown 支持以下这些符号前面加上反斜杠来帮助插入普通的符号:

\   反斜线
`   反引号
*   星号
_   底线
{}  花括号
[]  方括号
()  括弧
#   井字号
+   加号
-   减号
.   英文句点
!   惊叹号

大概就这么多吧,在写作过程中遇到麻烦的话还可以找度娘……如有遗漏。等我发现再补吧

著作权归罪歌moecopilot本人所有。商业转载请联系作者 QQ 1993713026 获得授权,非商业转载请注明出处。
Moecopilot is the original author. Please give credit to the original author when you use it elsewhere.