都别抢!那是我的锅!


Markdown

Markdown能够使作者最简单明了地撰写一份层次分明结构清晰的文档,官方的话来说就是一种“轻量级的标记语言”,嗯,这很官方。我们只要记住Markdown是一种写文档的利器就可以了,简单、方便,学习成本几乎为0。

Markdown

作为程序员,最常见的Markdown文档就是GitHub上大多数项目的README.md文件了,可以仔细观察这些README.md,会发现这些文档经常用到的“标记”就那么几个,所以并不是很难哟。

作为一种“轻量级的标记语言”,必须依靠编辑器才能正常使用,当然关于编辑器,现在有很多选择了,哪怕直接用文本编辑这类的编辑器,也是可以编辑Markdown的,这里给大家推荐“Typora”编辑器,Mac上、PC上都可以使用,区别于其他Markdown编辑器,“Typora”最大的有点就是,编辑时直接在编辑的窗口显示最后的效果,而不是像其他编辑器一样,左边一块编辑源文件的窗口,右边一块编辑后效果的窗口,视觉左右切换,累!

Typora的官网:https://typora.io

Markdown支持部分HTML标签

在Markdown中,也支持部分HTML标签,注意,这个特性十分有用,当Markdown自身提供的语法不能满足需求时,就可以用HTML标签来实现,比如上面的网址,如果单纯使用Markdown来做:

[https://typora.io](https://typora.io)

这样看起来当然是没问题的,但是当你把这片博文传到自己的博客上时,会发现只要一点这个链接,看博客的人就直接在当前页跳转到目标网址去了,除非在浏览器上点返回按钮,或者重新找到你的博客,不然就回不到你的博客了,这样明明是想用链接中的内容来扩展一下你想说的东西,结果就把阅读博客的人直接搞走了,不管从博主角度还是读者角度,这种操作是十分不方便的,除非目的就是让读者直接到目标网页去不要再回来,不然不推荐直接用这种方式编辑链接。

现在我们把HTML标签加入到Markdown文档中:

<a href="https://typora.io" target="_blank">https://typora.io</a>

这样就能实现在新的标签页打开目标网页了。

Markdown中常用的标记

标题

Markdown中的标题是用“#”来标记的,标题分为6级,标题下面不一定会带标题线,有没有线得看编译器,比如使用GitHub风格编译,所以在一级标题与二级标题下面会自动带上标题线。

#一级标题
##二级标题
###三级标题
####四级标题
#####五级标题
######六级标题

目录

注意,不是所有的Markdown编译器都支持目录标记,目录标记会根据标题自动生成目录。

[TOC]

列表

用 *+空格 来编辑无序列表,用 数字+.+空格 来编辑有序列表。

* 第一点
* 第二点
* 第三点

1. 第一点
2. 第二点
3. 第三点

分割线

用***来表示一个分割线。

***

代码

代码有两种表示方法:

  1. 用两个``包起来的代码。

    定义一个int变量:`int a;`
    
  2. 用两个行首的```包起来的代码。

    ​```
    int a;
    ​```
    

第一个方法一般用于段落内某一小段的代码,第二个方法一般用于代码块。

表格

其实表格是markdown中比较烦人的一个标记,但使用Typora完全不用担心这一点,至于为什么,大家试了就知道~

| 参数    | 类型     | 备注   |
| ----- | ------ | ---- |
| token | string | 用户口令 |
| uid   | string | 用户ID |

加粗

用一对**包起来的文字即可被加粗。

**呵呵哒**

斜体

用一对*包起来的文字即可变成斜体。

*呵呵哒*

链接

使用[文字](链接)即可编辑一个链接。

[我的博客](https://blogtc.com)

图片

使用![](图片地址)即可编辑一个图片

![](/Resource/GCD.png)

其他

当然Markdown中还有很多其他的标签,但部分标签设计的十分复杂,比如图表之类的,设计这些复杂的标签就违背了Markdown的初衷:简单方便快速地构建层次分明结构清晰的文档

超出这个范围的需求应该用更加专业的工具来完成相关工作,而不是觉得Markdown好,Markdown牛逼,我们让它更牛逼吧,然后使劲往里面塞复杂的功能。





未经同意,禁止任何形式的转载,作者保留一切权利。如需转载请联系作者

[email protected]



你的支持是我创作的动力之一



支付宝扫码