边写边学的Markdown之旅

边写边学的Markdown之旅

  为了提升自我的知识水平、书写水平、归纳总结水平,进而提高综合能力,这就学习了Markdown简单使用方法。这真是一门优秀、方便 、高效的标记语言。无论是应对记录日记闲谈,编写技术文档都可以无压力胜任。所以也来做一个边写边学的文档好了。

工具

Markdown语言本身就是普通的文本,不需要配什么使用环境。编辑工具推荐使用巨硬家的Visual Studio Code,配合Code插件库里的Markdown插件使用,简直方便。

目录

  • 标题
  • 正文
    • 占位符
    • 换行
    • 高亮
    • 斜体粗体
    • 删除线
    • 分隔线
    • 脚注
  • 列表
    • 无序列表
    • 有序列表
    • todo列表
  • 链接
    • 超链接
    • 图片
    • 脚注超链接
  • 引用
    • 普通引用
    • 代码引用
  • 表格
  • 制作目录
  • 其他

标题

使用#来标记为标题,最多可以到6级标题
# h1
## h2
### h3
#### h4
##### h5
###### h6

正文

正文自然是没有什么骚操作,正常写就是了。不过这里有几个小技巧需要注意。

占位符

每一段文字的开头,也许会想空两个字,这时就需要使用占位符

  “我轻轻的离去,没带走半个比特币,甚至还亏了不少。”

换行

这个不用多说,硬需求。
只需在行末加两个空格,然后回车即可。

高亮

`这样使用`

效果:

这样使用

斜体粗体

*斜体*
**粗体**
***斜粗体***

效果:

斜体
粗体
斜粗体

删除线

在文字的左右两边放两个~
~~就像这个~~,效果如下:
就像这个

分隔线

***/___/---都可以表示为分隔线。
注意使用---的时候,前面必须空一行,否则会使上一行变成标题。
效果:


脚注

使用脚注,首先需要在文章最后定义脚注:

[^脚注名]: 一句话注释。或者跳转链接

使用的时候只需要在想注释的地方插入[^脚注名]即可。

列表

Markdown支持以下几种列表。

无序列表

使用* 列表名即可标记为无序列表。子级列表比父级列表多一个tab缩进即可。

- 一级列表1
    - 二级列表1  
        - 三级列表1
        - 三级列表2
    - 二级列表2

效果:

  • 一级列表1
    • 二级列表1
      • 三级列表1
      • 三级列表2
    • 二级列表2

有序列表

有序列表与无序列表相似,只是将*换成了数字.

1. 第一章
    1. 第一节
        1. 第一条
    2. 第二节

效果:

  1. 第一章
    1. 第一节
      1. 第一条
    2. 第二节

todo列表

todo List yeah![1]

每天都要做的事:
* [ ] 吃肉 
+ [x] 喝水
- [x] 干活

效果:

  • [ ] 吃肉
  • [x] 喝水
  • [x] 干活

链接

超链接

插入超链接使用以下格式:

[显示文字](链接地址)  

全球最大的同性交友网站在哪里,[点击跳转](http://www.github.com)。

效果:

全球最大的同性交友网站在哪里,点击跳转。

图片

插入图片使用以下格式:
! [图片描述] (图片地址),图片描述可以为空。

![垃圾平台,坑我钱财,毁我青春](http://upload-images.jianshu.io/upload_images/73064-105883d76ec68ca9.png?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240)

效果:

垃圾平台,坑我钱财,毁我青春

(滑稽)

脚注超链接

在一些平台,超链接还支持脚注超链接:

在要使用的小节最后添加脚注:  
格式:
    [名字]: 链接地址
[1]: http://stackoverflow.com  

然后在想要使用的地方:  
代码遇到问题,去哪里?[点击跳转][1]

效果:

代码遇到问题,去哪里?点击跳转

引用

普通引用

单纯使用一个缩进开头,即可完成普通行引用,引用前需要空出一行才能生效。
这种引用会让引用文字中的Markdown语法失效,不过很适合拿来做Markdown语法教程!?

使用tab或
4个空格开头即可
# 我是标题,但我没生效欸
*** 分隔线表示心里平衡

使用> 开头
即可标记为引用
如果想再引用中插入前一种引用需要开头缩进两个Tab

  不缩进是不可能的,那这辈子都是出不来引用效果的。

代码引用

使用如下格式即可对代码块完成引用:

``` 代码语言

代码

```

``` Java
public interface IView {
    void show();

    void hide();
}
```

效果:

public interface IView {
    void show();

    void hide();
}

表格

| 水果  | 价格 | 数量 |
| :---: | ---- | ---: |
| 香蕉  | 1元  | 5    |
| 苹果  | 2元  | 6    |
| 草莓  | 3元  | 7    |

第二行为每一列的文字重力做出描述,默认居左---/居右---:/居中:---:
效果:

水果 价格 数量
香蕉 1元 5
苹果 2元 6
草莓 3元 7

制作目录

其实这个功能,还是看例子比较好。
就拿这整篇文章做例子吧。

- [标题](#标题)
- [正文](#正文)
    - [占位符](#占位符)
    - [换行](#换行)
    - [高亮](#高亮)
    - [斜体粗体](#斜体粗体)
    - [删除线](#删除线)
    - [分隔线](#分隔线)
    - [脚注](#脚注)
- [列表](#列表)
    - [无序列表](#无序列表)
    - [有序列表](#有序列表)
    - [todo列表](#todo列表)
- [链接](#链接)
    - [超链接](#超链接)
    - [图片](#图片)
    - [脚注超链接](#脚注超链接)
- [引用](#引用)
    - [普通引用](#普通引用)
    - [代码引用](#代码引用)
- [表格](#表格)
- [制作目录](#制作目录)
- [其他](#其他)

如聪明的你所见,这就整个一链接的格式嘛,只不过前面多一个-,再配合缩进分级而已。
不得不说Markdown大法好啊!

其他

以上就是常用的Markdown基本语法,已经能够解决我的文字编写需求啦。还有像数学公式流程图序列图,甘特图等高级使用方式,暂时用不上,就先不学啦。

放空自我->从心->


感谢阅读


  1. 其实很多地方-、+、*三个符号都可以互换,它们都起到相同的作用。 ↩

你可能感兴趣的:(边写边学的Markdown之旅)