简书 markdown 语法入门
作为一个程序员,我个人是非常喜欢用简书的,因为简书上的文章大部分都有清晰的条理结构和优雅的界面,这对技术类文章是非常重要的。好了,废话不说,下面我们就了解一下写文章时需要用到的一些markdown语法。让自己也能写出界面优雅、条理清晰的文章。
0.前置条件
我们要使用带有markdown特殊格式的文章排版,必须要将基础设置里面的常用编辑器设置为markdown。设置流程如图:
image.png image.png1. 标题
标题用1~6个#号标记,分别代表 一级~六级标题,多余6个以上的#自动蜕变为普通文字。
标题语法如下:
#标题名
# 一级标题
## 二级标题
### 三级标题
#### 四级标题
##### 五级标题
###### 六级标题
####### 哈哈,没有7级标题哦
效果如下:
image.png2. 代码框
作为开发者,插入代码框是必须要会的。代码框语法为,也就是因英文状态下的波浪线(~)那个按键。
代码框语法如下:
``` 代码块 ```
```
override func viewWillAppear(_ animated: Bool) {
super.viewWillAppear(animated)
let configuration = ARWorldTrackingConfiguration()
sceneView.session.run(configuration)
}
```
效果如图:
3.代码片
这个东西跟代码框其实差不多,只不过当一行的代码足够长时,代码框可以左右滑动,而代码片不会,代码片会在其包裹的内容上蒙上一层淡淡的底色。
代码片语法:
` 代码块 `
`
let gridMaterial = SCNMaterial() gridMaterial.diffuse.contents = UIImage(named: "art.scnassets/grid.png")
plane.materials = [gridMaterial]
`
效果如图:
image.png4.无序列表
无序列表的实现方式很简单,有三种:分别在文字前面加上 * 、- 、+ 中的其中一种即可。注意符号需要与文字空一个空格。
无序列表语法:
* 文字
- 文字
+ 文字
* 无序列表1
- 无序列表2
+ 无序列表3
效果如图:
image.png5.有序列表
有序列表的实现是 ‘数字加点’,后面接上需要描述的文字即可,注意需要要与文字空一个空格。
有序列表语法:
数字编号. 文字
1. 有序列表1
2. 有序列表2
效果如图:
image.png6.引用
我们在写文章时,有时需要借鉴、引用他人的文字或论证,这时引用就变得有必要了。引用语法很简单,一个 > 符号就可以。
引用语法:
> 所引用的内容
>凤兮凤兮归故乡,遨游四海求其凰
>凤凰鸣矣,于彼高岗;梧桐生矣,于彼朝阳
效果如图:
image.png7.强制换行
markdown编辑器下直接回车,预览时换行是显示不了的。这时就需要强制换行了。
强制换行语法:
<br>
<br>
效果图:略
8.转义字符
当我门需要直接打印出每个带有图书意义的字符时,就需要一个转义字符,讲那个特殊字符转换为普通字符,这时才能打印。比如代码框符号```,引用符号>等。这个转义字符就是反斜杠 \。
转义字符语法:
\需要转义的字符
\```
\>
\<br>
效果如图:
image.png9.链接
当我们的文章有需要跳转其他资源的需求时,此时就需要一个链接。链接的标记格式为[需要跳转资源的文字描述
](http资源地址
),这样我们点击文字描述,就能直接跳转到相应的资源。
链接语法:
[需要跳转资源的文字描述](http资源地址)
你可以在 [简书](http://www.jianshu.com/) 上写出优美的文章
效果如图:
image.png10.插入图片
插入图片的语法跟链接差不多,多一个!,标记格式为[想要显示的图片名
](图片地址
)
插入图片语法:
[想要显示的图片名](图片地址)
![美女小姐姐](https://img.haomeiwen.com/i2978034/fd317044c63cd724?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240)
效果如图:
image.png