markdown新手入门使用指南

傷城~ 2022-05-31 01:59 295阅读 0赞

*  markdown介绍
 *  从目录和标题开始说起
 *  一级标题
    
     *  二级标题
        
         *  三级标题
            
             *  四级标题
 *  插入图片
 *  块引用
 *  代码块引用
 *  列表
 *  对字体进行一些设置
 *  总结

# **1.markdown介绍** #

> Markdown 是一种轻量级标记语言，它允许人们使用易读易写的纯文本格式编写文档，然后转换成格式丰富的HTML页面。 —— 维基百科  
> CSDN提供编辑器支持 Markdown Extra , 　扩展了很多好用的功能。具体代码请参考Github.当你开始接触markdown你要认识一种全新的格式叫做顶格格式，现在已经有好多书开始使用这种格式了，我们不在专门空两个空格，而是直接采取齐头式

# 2.从目录和标题开始说起 #

> 平常我们在写一篇文章的时候最常用的无非也就是这两个东西，我们需要建立一个目录，同时也需要进行对每一部分进行分节，每一个目录对应一个小节。一个\#代表一级标题，就跟word一样，我们可以使用一个\#或者多个\#来确定我们是第几级标题

# 一级标题 #

## 二级标题 ##

### 三级标题 ###

#### 四级标题 ####

这个标题大家可以通过目录最上方的目录有一个深刻的理解。上面的这个内容是怎么显示出来的呢，我们可以通过下面这幅图片知道我输入的内容和实际显示的内容  
![图一][SouthEast]

接下来我们要看到目录并不是标题，而只是一种放大了的字体而已，这是如何实现的呢，其实是利用了编辑器中的内嵌的Html语句， 
`目录利用了这么一条语句就能实现将目录字体放大`

# 3.插入图片 #

和之前的编辑器插入的方法差不多，虽然也有利用代码插入的，但是觉得那样的方法其实并不是很快，可以利用快捷键`ctrl +G`插入本地图片,按出快捷键之后，就会有一个窗口提示你上传需要插入的图片

# 4 .块引用 #

> 有时候我们需要讲一句话放入到一个块中,就像现在这样，怎么实现呢

我们只需要将这句话前面加上一个符号>即可，那么又开始就一定有结束我们如何终结这个退出这个块儿切换到普通的模式输入文字呢， 我们只需要在块的最后一行中敲击一个空格，然后再按一下回车就可以切回到非块的编辑模式中。

# 5.代码块引用 #

*  markdown是支持进行代码块的，那么如何实现呢，大家看下面这段代码

@requires_authorization
     def somefunc(param1='', param2=0):
         '''A docstring'''
         if param1 > param2: # interesting
             print 'Greater'
         return (param2 - param1 + 1) or None
     class SomeClass:
         pass
     >>> message = '''interpreter ... prompt'''

这是一段python脚本如何将这一部分代码放入代码框中呢，我们可以利用键盘左上角的波浪线符号，位于esc键下面当输入法处于英文模式时，你敲入这个键其实就是\`。也就是句号前的那个符号。下面截图演示  
![这里写图片描述][SouthEast 1]

> 从图片中我们可以看出代码块的实现格式其实就是个代码开头 三个\`符号，然后输入代码名字是java python 还是shell，最后在代码尾部再加上三个宇开头相同的符号即可

# 6.列表 #

*  有序列表  
    有序列表就是像这样能有个一二三的排列的  
    1.列表一  
    2.列表二  
    3.列表三  
    实现方式也很简单，就是数字加上英文.即可
 *  无序列表  
    无序列表的实现方式一般就是+ - \*这三种符号的其中一种加上文字
 *  列表1
 *  列表2
 *  列表3  
    上面的实现机制，我们能够通过截图来演示。  
    ![这里写图片描述][SouthEast 2]

# 7.对字体进行一些设置 #

我们在平常也会需要对字体进行一些设置，其实也就单单调整下大小和颜色对于新手而言你不需要知道很多的命令只需知道常用的即可

* 调整颜色 
 字体调整为蓝色 
 语法:`+文本内容`可以使中间的文本内容字体变色 
 当然，这个颜色你可以自己上网百度有很多种颜色可以供你选择，平常我们能用得到的基本上也就蓝色跟红色，专门用这个来标注一下醒目的笔记啊，感受啊这之类的
 * 调整字体 
 字体变大 
 语法：`字体变大` 这句文本可以使中间的内容大小改变

# 总结 #

其实作为新手我们只需要掌握以上这些基本的内容就完全足以我们平常写博客和写文档的使用了，当然一开始，你会很不习惯这样的齐头式的文本，但是慢慢你就会发现这种文本是极客们比较喜欢的一种方式。因为效率是比较高的

[SouthEast]: /images/20220531/af09ae3d563442d7b197b3b5be9398b3.png
[SouthEast 1]: /images/20220531/2e1617a506314707b00ad2640e4cb1ec.png
[SouthEast 2]: /images/20220531/d2705d3f580d4436b6adf5549d510e55.png