第五周作业-Markdown的使用心得

  在个人项目的时候,是我第一次接触到Markdown,也是在老师的提议下我们才会使用到Markdown的。当时个人项目的说明文档,只用到了一些简单的语法。而这次需求说明书的编写,由于内容更多更复杂,使我对Markdown的学习也有了更深的心得。

  首先简单地说下我对Markdown的认识。Markdown是一种可以使用普通文本编辑器编写的标记语言,通过简单的标记语法,它可以使普通文本内容具有一定的格式。用户可以使用诸如 * # 等简单的标记符号以最小的输入代价生成极富表现力的文档。

  Markdown具有很多优点:

  • 写作中添加简单符号即完成排版,所见即所得。让你专注于文字而不是排版。
  • 格式转换方便,Markdown 的文本你可以轻松转换为 html、pdf等。
  • 可以保存称纯文本。

  支持Markdown的编辑器太多,功能也不完全一致,有的是用来进行基本的写作,有的是用来写代码的,有的甚至只是博客平台配套的编辑器。国内至少有50家新的博客网站,都是以自定义、Markdown、简约、干净大方的特点出现的,而且一般都有自己定制的Markdown编辑器(网页版的或者离线版的,farbox就是离线版的)。而且因为Markdown语法支持编程语法高亮显示,这使得几乎所有的使用Markdown的博客网站都以“这里是给程序员准备的”为宣传语。密集的程序员社区更是数不胜数,有些是支持Markdown的,有些是支持LaTeX的。或者说国内网站的论坛、博客、社区,比较优秀的,开源的,不收费的,这样的地方,基本上都被程序员们占领了。

  在这个过程中我所使用的是“小书匠”和“MarkdownPad2”这两个编辑器。刚开始的时候我只是在“小书匠”上面编写,后来发现上传至coding上面的效果和“小书匠”的预览效果并不相同,如,“[TOC]”可以生成目录,而在coding的网页上并不可以,还有换行上面也不一致……

  关于Markdown语法的介绍,网络上还是挺多的。也就是说我如果要查一个我不太熟悉的编程语言的使用方法,原来我可能会去CSDN,而现在我只要百度一下,就会出现各种博客、社区、论坛在大规模讨论这些编程问题,都是展示自己的开源程序,各种命令行,各种高亮显示。下面我贴出来一些我使用到的语法:

1. 标题设置(让字体变大,和word的标题意思一样)
在Markdown当中设置标题,有两种方式:
第一种:通过在文字下方添加“=”和“-”,他们分别表示一级标题和二级标题。
第二种:在文字开头加上 “#”,通过“#”数量表示几级标题。(一共只有1~6级标题,1级标题字体最大)


2. 块注释(blockquote)
通过在文字开头添加“>”表示块注释。(当>和文字之间添加五个blank时,块注释的文字会有变化。)

3. 斜体
将需要设置为斜体的文字两端使用1个“*”或者“_”夹起来

4. 粗体
将需要设置为斜体的文字两端使用2个“*”或者“_”夹起来

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

6. 有序列表
使用数字后面跟上句号。(还要有空格)

7. 链接(Links)
Markdown中有两种方式,实现链接,分别为内联方式和引用方式。

内联方式:This is an [example link](http://example.com/).
引用方式:

I get 10 times more traffic from [Google][1] than from [Yahoo][2] or [MSN][3].

[1]: http://google.com/ "Google"
[2]: http://search.yahoo.com/ "Yahoo Search"
[3]: http://search.msn.com/ "MSN Search"

8. 图片(Images)
图片的处理方式和链接的处理方式,非常的类似。
内联方式:![alt text](/path/to/img.jpg "Title")
引用方式:

![alt text][id] 

[id]: /path/to/img.jpg "Title"

9. 代码(HTML中所谓的Code)
实现方式有两种:
第一种:简单文字出现一个代码框。使用`<blockquote>`。(`不是单引号而是左上角的ESC下面~中的`)
第二种:大片文字需要实现代码框。使用Tab和四个空格。

10. 脚注(footnote)
实现方式如下:
hello[^hello]
[^hello]: hi

11. 下划线
在空白行下方添加三条“-”横线。(前面讲过在文字下方添加“-”,实现的2级标题)

原文地址:https://www.cnblogs.com/LH956574963/p/5352855.html