有一种文档格式叫Markdown,有一种情怀叫简单就是美!

markdown简单易用(无门槛学习程序员文档神器)(1)

Markdown是什么东东,为什么要用?

它是一种文档格式(也叫md),大家可能用过或见过“.doc”、“.docx”、“.htm”等不同后缀名的文件,代表了Word或者网页文件,这些文件已经非常成熟和通用了,为什么还要用Markdowd呢(文件后缀为.md或者.markdown)?它的优点如下,看看有没有get到你。

专注于你的文本内容而不是排版样式,安心写作(内容为王)

直观、易于阅读、学习成本低(看完本文档就差不多了_)

可以导出HTML、pdf、PNG等

纯文本内容,兼容所有的文本编辑器与字处理软件

据说很多国内外网络小说作家以及文学创作者都在开始使用Markdown了。

用什么工具写Markdown?

编写Markdown文档,可以直接在线进行,比如CSDN提供的在线Markdown编辑器( https://editor.csdn.net/md/)(别着急点,可以看完本文后再过去:) )。也可以下载一个本地工具,不依赖于网络环境也能够进行码字码代码,本文推荐VSCode(免费、流行、好用)。

接下来结合VSCode工具(编写文档的地方)和Markdown语法(格式约定)一起学习使用md!

下载安装VSCode

官网下载地址:单击此处下载

markdown简单易用(无门槛学习程序员文档神器)(2)

选择匹配的操作系统版本进行下载。下载后安装过程比较简单,一路“下一步”直到“完成”即可。

进行汉化[非必选项]

打开VSCode,使用快捷键Ctrl Shift P,在出现的输入框中输入configure display language,回车确认,在出现的输入框下选择Install additional languages,en代表英文。

在主界面的扩展插件中点击“Chinese (Simplified) Language Pack for Visual Studio Code”点击“Install”重启即可。

安装PDF插件[非必选项,图个方便]

安装PDF插件可以将Markdwon文件导出为PDF、图片等格式。编辑好的内容面向“普通”用户,还是需要“包装”一下(md深藏功与名)。

在扩展插件中输入“Markdown PDF”,选择安装即可。

markdown简单易用(无门槛学习程序员文档神器)(3)

至此,万事俱备只欠东风,可以开始在VSCode中编写Markdown文档了。

简洁的语法,不简单的效果

写一个文档,主要结构无非是:“标题”,“正文”、“列表”、“图片”。除了这几个元素,可能部分文字需要修饰一下,比如“加粗”、“斜体 ”。超链接也是互联网传播不可或缺的元素。除了这些,Markdown还提供插入“代码”、“引用”和“分割线”等。当然你想要在文档中插入一个“表格”也是可行的。嗯,差不多了,这些够我们现在学一壶了。

接下来,在VSCode中我们来一一尝试吧。

VSCode创建一个md文件

在VSCode中创建一个文件,保存文件时扩展名(后缀名)为“.md”,这样VSCode,就可以识别,并按照Markdown的语法进行解析。

markdown简单易用(无门槛学习程序员文档神器)(4)

创建md文件后在侧边上栏会有一个按钮(打开侧边预览),单击后我们就可以以一遍写md文档,一遍即时查看文档效果。

markdown简单易用(无门槛学习程序员文档神器)(5)

我们可以开始愉快地编写md文档了。

markdown简单易用(无门槛学习程序员文档神器)(6)

md:标题

标题可以分为六级,从一级到六级。一个井号(#)代表一级,如下图所示(注意多个井号之间不要有空格,写完井号,至少要有一个空格,然后开始写标题)。

markdown简单易用(无门槛学习程序员文档神器)(7)

一般来讲,一个文档有六个级别的标题是够用了,每个标题都独立占据一行。在上面的图片中测试了没有使用标题标记与使用标题标记的区别。

md:正文

关于正文就比较简单了,直接开启你的天赋技能:写写写、敲敲敲即可(风声雨声键盘声,声声入耳~ )。

md文档中编写正文的测试如下图所示,注意段落间换行。不用把注意放在空格、对齐等无关内容的事项上,把你的文思泉涌展现出来就可以了。

markdown简单易用(无门槛学习程序员文档神器)(8)

md:列表

列表分为有序列表和无序列表。这也是撰写文档时经常使用到的点。

markdown简单易用(无门槛学习程序员文档神器)(9)

列表嵌套的时候,下一级可以用键盘上的“Tab”键进行缩进,其他不用太纠结。

md:图片

显示图片首先要考虑路径的问题,为了方便演示,此处用一个互联网上的图片做演示(如果是计算机本地图片最好使用相对路径)。路径的核心是:你的md文档能够时刻找到你的图片,md文档中的图片仅仅是一个引用而已。

markdown简单易用(无门槛学习程序员文档神器)(10)

![图片名](图片地址)

显示图片需要用到的三种符号:

感叹号“!”是必须的;中括号“[]”中间可以写图片名称,如果图片不能正确显示,会显示名称;小括号“()”中间写图片正确路径,路径后用空格隔开链接一个双引号可以写一个图片提示文本,这样鼠标悬停到图片上会有提示文本出现,如上图所示,这个提示文本不是必选项。

注意:符号都需要在英文输入状态下录入。

md文档主要以文字为主,对图片仅仅是一个引用,如果你想调整图片大小、居中…这个就没有必要了,图片不宜过多(嗯,虽然本文图片不少~)。

md:超链接

超链接的用法与图片非常相似,没有了图片的感叹号“!”,中括号中写超链接显示内容,小括号中写实际的链接地址。

[显示文字](超链接地址)示例:[C站能力认证中心](https://ac.csdn.net/)

md:一些特殊格式

## 特殊格式### 加粗床前 **明月** 光​### 斜体​床前 *明月* 光​### 删除线​床前 ~~明月~~ 光​### 分割线​三个连续星号​***​三个连续减号​---​三个连续下划线​___​### 转意​\\​\*​\-​​

markdown简单易用(无门槛学习程序员文档神器)(11)

==强调文本用双等号包裹起来,效果如下==强调文本H~2~O 下标效果如下H2O2^10^ = 1024 上标效果如下210 = 1024

md:代码和引用

单行代码引用,用`号包裹起来就可以(是键盘上1前面的那个符号,不是单引号)

示例: print 'Hello !'

详见下面图片。

markdown简单易用(无门槛学习程序员文档神器)(12)

可以在代码块明确部分语言,实现部分代码高亮样式

markdown简单易用(无门槛学习程序员文档神器)(13)

markdown简单易用(无门槛学习程序员文档神器)(14)

md:表格

表格的作用在于清晰展示数据横向和纵向关系,可尽量避免合并单元格。

编号|姓名|成绩:-|:-:|-:1001|孙大圣|971002|猪小能|871003|沙编程|39

markdown简单易用(无门槛学习程序员文档神器)(15)

后记

整理好的文档可以利用VSCode的导出功能导出为PDF格式,与小伙伴分享了。

markdown简单易用(无门槛学习程序员文档神器)(16)

选择pdf进行导出(界面上没有明显提示…),会在md文档同目录下生成pdf文件。

markdown简单易用(无门槛学习程序员文档神器)(17)

有了以上基本规则的学习,小伙伴们就可以利用Markdown在学习和工作中自由翱翔了!

,