markdown笔记:markdown的基本使用

既然要写技术博客,那么markdown肯定是必备的了,这篇文章就来介绍一下markdown的基本使用操作。

References

电子文献:
https://www.jianshu.com/p/191d1e21f7ed


介绍

Markdown是一种可以使用普通文本编辑器编写的标记语言,其功能比纯文本更强,因此许多程序员用它来写blog。在这里我先推荐一款markdown编辑器——typora,大家可以免费下载使用。


注意

在我刚开始使用markdown的时候总是跳进这个坑,在这里提上来提醒一下,在使用markdown标记后要添加文字时,需要在相应标记后空一格,否则标记也会被当作文本来处理,例如我输入“#####错误”时:

错误

正确的做法是输入“##### 正确”:

正确

一种简单的判别方法就是使用IDE,这样对应的标记就会有语法高亮。


使用

  1. 标题

    话不多说,直接示范:

    1
    2
    3
    4
    5
    6
    # 这是一级标题
    ## 这是二级标题
    ### 这是三级标题
    #### 这是四级标题
    ##### 这是五级标题
    ###### 这是六级标题

    效果如下:

    这是一级标题

    这是二级标题

    这是三级标题

    这是四级标题

    这是五级标题
    这是六级标题
  2. 字体

    还是直接示范:

    1
    2
    3
    4
    **这是加粗的文字**
    *这是倾斜的文字*`
    ***这是斜体加粗的文字***
    ~~这是加删除线的文字~~

    这是加粗的文字
    这是倾斜的文字
    这是斜体加粗的文字
    这是加删除线的文字

  3. 引用

    1
    2
    3
    4
    >我引用
    >>我还引用
    >>>我再引用
    >>>>>>>>>>>>>扶我起来,我还能继续引用!

    我引用

    我还引用

    我再引用

    扶我起来,我还能继续引用!

    引用是可以嵌套的,可以加很多层,我一般使用一个>来表示额外的需要注意的内容。另外,如果想让下一段文字不被引用,需要空一行。

  4. 分割线

    分割线使用三个及以上的-*就可以。
    有时候用---会造成别的文字的格式变化,因此我在使用VScode编辑时,如果看到---被高亮(分割线正常其作用时应该不高亮),就会改用***

    1
    2
    ---
    ***

    效果如下:



  5. 图片

    markdown中添加图片的语法是这样的:

    1
    ![显示在图片下方的文字](图片地址 "图片title")

    其中title可加可不加,它就是鼠标移动到图片上时显示的文字。
    然而我在使用hexo搭建我的个人博客的过程中,遇到了使用上述语法图片却无法显示的情况,因此我改用了下列标签插件:

    1
    {% asset_img xxxxx.xxx 图片下方的名字 %}

    其中xxxxx.xxx只需直接输入图片名称以及格式即可,因为我使用了hexo-asset-image插件,它可以在_posts文件中创建与博文名称相同的对应的文件夹,只需把图片移入即可。注意,这里的图片名中间不能有空格,否则会加载失败(它会以为图片名称到第一个空格为止)。
    其安装命令:npm install hexo-asset-image --save
    也可用cnpm更快地安装:cnpm install hexo-asset-image --save

    补充:后来发现在关于本人中无法使用上述asset_img标签插件来对图片进行插入,故又尝试了![显示在图片下方的文字](图片地址 "图片title")的方法,发现可行!原因可能是之前误用了中文括号导致的。可以参考一下Hexo文章中插入图片的方法

    在插入图片的后面,会留有一小段空白区,看着不舒服的话可以不要回车,即直接在插入图片的语句后面跟进下一段的文字或者图片等,这样行间隙就会小很多。
    其实在hexo中可以直接使用img标签,它会自行处理,并且这样还更方便调整高度和宽度。

    1
    <img src="" width="50%" height="50%">
  6. 超链接

    由于我希望在新的页面打开链接,而似乎markdown本身的语法不支持在新标签页打开链接,因此我推荐直接使用html语言来代替。

    1
    <a href="超链接地址" target="_blank">超链接名</a>
  7. 列表

    • 无序列表

      1
      2
      3
      - 列表内容
      + 列表内容
      * 列表内容
      • 列表内容
      • 列表内容
      • 列表内容
    • 有序列表

      1
      2
      3
      1. 列表内容
      2. 列表内容
      3. 列表内容
      1. 列表内容
      2. 列表内容
      3. 列表内容
        可以看到,上面显示的列表是有嵌套的,方法就是敲三个空格缩进。
  8. 表格

    1
    2
    3
    4
    表头|表头|表头
    ---|:--:|---:
    内容|内容|内容
    内容|内容|内容

    其中第二行的作用分割表头和内容,-有一个就行,为了对齐可多加几个。
    此外文字默认居左,有两种改变方法:
    两边加:表示文字居中。
    右边加:表示文字居右。
    然而我在hexo使用表格时,出现了无法正常转换的问题,因此我改用了如下HTML的表格形式。

    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    <table border="1">
    <tr>
    <td>第一行第一列</td>
    <td>第一行第二列</td>
    </tr>
    <tr>
    <td>第二行第一列</td>
    <td>第三行第二列</td>
    </tr>
    </table>

    效果如下:

    第一行第一列第一行第二列
    第二行第一列第二行第二列
  9. 代码

    最后的最后,是我最喜欢ctrl+C+V的代码了。
    单行或句中代码输入方式:

    1
    `来复制我呀`

    显示:
    来复制我呀
    其中“`”在键盘的左上角,我当初找了好久。
    多行代码块的写法就是用上下两对“```”围住。
    好了于是你现在就可以自由的复制粘贴啦。


碰到底线咯 后面没有啦

本文标题:markdown笔记:markdown的基本使用

文章作者:高深远

发布时间:2019年09月13日 - 21:11

最后更新:2020年02月07日 - 16:51

原始链接:https://gsy00517.github.io/markdown20190913211144/

许可协议: 署名-非商业性使用-禁止演绎 4.0 国际 转载请保留原文链接及作者。

0%