MarkDown使用指南

Author Avatar
ahscuml 3月 18, 2018
  • 在其它设备中阅读本文章

我与markdown的渊源。

使用原因

  主要还是因为Word不太好用,例如需要调整字体的间距,总觉得Word字体的间距太大了,不适合操作,而且其他方面编辑好以后如果需要加载到网页上,还涉及到格式转换的问题因此采用了markdown来书写,一个是书写文字非常方便,其次就是上传到自己的博客上也很方便,不涉及文字格式的从转换。

软件

  我在Windows上使用的是MarkDownPad这款软件,其他软件我也没有使用过,首先这款软件很多人推荐,其次这款软件使用起来也很方便,很简洁。其次在很多地方都可以使用MarkDown,例如IDEA编译器也可以。
  最近我开始使用vsCode来进行写作,不得不说真的是好用,颜色方面很有优势,看起来很舒服,还有各种插件,渲染完成的也很好,推荐。
  看起来markdow使用比较繁琐,毕竟是一个新鲜的事物,我在第一次尝试的时候感觉很麻烦。但是当你真正使用起来,真正掏出30分钟来研究一下的话,还是很好上手的毕竟这仅仅是一个文本编辑器,最终还是要用来写字。

语法简述

本文主要参考这份语法做出的简单整理MarkDown中文使用文档

  • 标题
    使用# 来标识
    #h1级标题
    ##h2级标题
    ###h3级标题
    ####h4级标题
    #####h5级标题
    ######h6级标题
  • 列表(注意符号和文本之间增加一个空格)

    • 有序列表
      使用1.
    • 无序列表
      使用*
  • 图片
    ![链接名](链接) 小括号中存放链接
    note:
    关于插入图片,由于markdown使用链接,所以我通常会使用图床来上传图片生成链接,推荐使用新浪微博图床 有专门的Chrome插件,非常方便。

  • 超链接
    [链接名](链接) 小括号中存放链接
  • 代码
    使用 `包围代码,同时还可以利用名称来使代码高亮

    ```java
    ```

  • 引用
    在文本前加入 >

  • 换行
    空格 + 空格 + 回车
  • 分割线 三个以上的短线
    使用 ***或者 ---
  • 删除线
    利用~~删除的内容~~设置删除线

  • 强调
    利用 *内容* 来进行斜体展示
    利用 **内容** 来进行粗体展示

  • 表格

    name | age
    —  | —
    a  | 10

GitHub不支持表格…除非使用HTML语句

  • 事项列表

    - [ ] eat
    - [x] eat
      - [ ] eat

效果:

  • eat
  • eat
    • eat
  • 版本控制语法
    与编写代码的语法类似,只不过代码的语言换成diff,同时以+开头表示新增,以-开头表示删除
    似乎在博客上无法解析这个语法
    `diff
  • 我是新增加的内容
  • 我是减少的内容
    `

This blog is under a CC BY-NC-SA 4.0 Unported License
本文链接:https://ahscuml.github.io/为什么使用markdown/