工欲善必先利器:Markdown基础用法

引言

 前几天换了工作,大约是996,在完成工作后决定能静下心来做一些有意义的事,准备将我入行4年多来(写在2019年)的收获进行整理。这篇文章将是我小菜鸟的第一篇文章。

准备工作:了解下载Markdown

1. 什么是Markdown

Markdown

 Markdown是一种可以使用普通文本编辑器编写的标记语言,通过简单的标记语法,它可以使普通文本内容具有一定的格式。

 简书的书写就是使用的Markdown语法。

2. Mac OS下的Markdown编辑器

 我使用的Markdown编辑器名字叫“MacDown”,是一款免费软件,附上下载地址
MarkDown下载地址

直接开整:Markdown语法

1. 文本编辑

 就是最常见的文本输入,不过要注意“空格”、“换行”,因为Markdown主要针对的是英文输入,所以对于我们习惯首行缩进并不友好,所幸Markdown对于HTML标签也是支持的所以我们可以用 来表示全方大的空白,或者使用 表示半方大的空白;

正常文字
 半方大的空白
 全方大的空白

正常文字
 半方大的空白
 全方大的空白
正常文字

 换行有两种方式,第一种就是直接敲出回车,另一种就是使用标签<br>

第一行<br>第二行

第一行
第二行

2. 文字属性

 文字有时候需要进行加粗倾斜斜体加粗删除线、字符转义则是前面加\
**加粗**
*倾斜*
***斜体加粗***
~~删除线~~
\*星号\*

*星号*

3. 标题

 标题也很简单,标识符是#,1号标题是#,2号是##,以此类推,最小应该是6号######
#1号标题
##2号标题
###3号标题
####4号标题
#####5号标题
######6号标题
#######7号没了

1号标题

2号标题

3号标题

4号标题

5号标题
6号标题

#######7号没了

4. 项目符号与编号

 相对应Word中的项目符号 和编号1.注意符号和后面文字之间有空格
- 哈哈
+ 哈哈
* 哈哈
1. 哈哈

  • 哈哈
  • 哈哈
  • 哈哈
  1. 哈哈

5. 引用

 引用就是你引用其他内容,当然也可以当做框出一块作为块单元使用。引用分两种,“多行引用”和“嵌套引用”,多行引用只需要在引用前加>,下一行有内容也会被引用,不想继续引用就要回车和上一行进行切割;
>多行引用
继续引用

不引用

多行引用
继续引用

不引用

 如果要进行引用内换行继续引用可以使用标签<br>
>引用
<br>换行引用

引用

换行引用

 嵌套引用,就是再次引用另一个进行缩进,使用多个>标识,层级越里,>个数越多,应该是可以嵌套很多层

第一层引用

第二层引用

第三层

.....

6. 代码和语法高亮

 单行代码最便捷使用用` `,多行可以使用并且代码自动高亮``` ```
`UIView *view = [[UIView alloc] init];`
```
UIView *view = [[UIView alloc] init];
[self.view addSubview:view];
```

UIView *view = [[UIView alloc] init];

 UIView *view = [[UIView alloc] init];
 [self.view addSubview:view];

7. 超链接

 超链接就是可以链接跳转的文字例如百度网
[百度网](https://www.baidu.com)

8. 图片

 插入图片的语法和超链接的语法基本一致,只是在最前面多一个 !。
![琉璃](http://upload-images.jianshu.io/upload_images/2120646-ef4e88ce41acbdee.jpg?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240)

琉璃

目前我没找到一个用语法来改变图片大小的方法(在简书上有效),可以教教我这个小菜鸡

9. 表格

 表格是我觉得Markdown最好用的语法了。使用|来分隔不同的单元格,使用 -来分隔表头和其他行:
参数名| 参数类型| 注释
---| ---| ---
Name| String| 名字
Age| Int| 年龄

参数名 参数类型 注释
Name String 名字
Age Int 年龄

是不是这种方式写接口文档快乐很多,对齐方式也是不同,另外表格还可以添加超链接和图片,以及文字特殊编辑

  • 左对齐 :---
  • 居中对齐 :--:
  • 右对齐 --:

左| 中| 右
:---| :---: | ---:
1|1|1
111|1111|111

1 1 1
百度
琉璃
111
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 220,639评论 6 513
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 94,093评论 3 396
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 167,079评论 0 357
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 59,329评论 1 295
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 68,343评论 6 397
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 52,047评论 1 308
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 40,645评论 3 421
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 39,565评论 0 276
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 46,095评论 1 319
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 38,201评论 3 340
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 40,338评论 1 352
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 36,014评论 5 347
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 41,701评论 3 332
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 32,194评论 0 23
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 33,320评论 1 272
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 48,685评论 3 375
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 45,345评论 2 358

推荐阅读更多精彩内容

  • Markdown概述 宗旨 Markdown 的目标是实现「易读易写」。Markdown 的特点就是,让写作变得更...
    心疼你萌萌哒阅读 7,764评论 1 24
  • 为了方便查找使用我就留一份(部分修改)在这作者地址在下方:<< 访问 Wow!Ubuntu Markdown 语法...
    公孙墨岚阅读 1,788评论 0 5
  • 基本语法 换行 行尾加两个空格,然后加return键 不换行测试哈哈效果如下:测试 哈哈 换行测试 哈哈效果...
    WiseDarren阅读 810评论 0 0
  • Markdown: 语法 概述哲学行内HTML特殊字节自动转换 区块元素段落和换行标题区块引用清单程序代码区块分隔...
    四颗豆阅读 383评论 0 0
  • << 访问 Wow!Ubuntu NOTE: This is Simplelified Chinese Edit...
    临城阅读 6,525评论 4 44