markdown语法从头讲到脚

作为一个程序员,我个人是非常喜欢用简书的,因为简书上的文章大部分都有清晰的条理结构和优雅的界面,这对技术类文章是非常重要的。好了,废话不说,下面我们就了解一下写文章时需要用到的一些markdown语法。让自己也能写出界面优雅、条理清晰的文章。

0.前置条件

我们要使用带有markdown特殊格式的文章排版,必须要将基础设置里面的常用编辑器设置为markdown。设置流程如图:

image.png
image.png

一、Markdown语法基础篇

1. 标题

标题用1~6个#号标记,分别代表 一级~六级标题,多余6个以上的#自动蜕变为普通文字。
语法

#标题名

示例:

# 一级标题
## 二级标题
### 三级标题
#### 四级标题
##### 五级标题
###### 六级标题
####### 哈哈,没有7级标题哦

效果

image.png

2. 代码框

作为开发者,插入代码框是必须要会的。代码框语法为,也就是因英文状态下的波浪线(~)那个按键。
语法

``` 代码内容 ```

示例:
```
override func viewWillAppear(_ animated: Bool) {
super.viewWillAppear(animated)
let configuration = ARWorldTrackingConfiguration()
sceneView.session.run(configuration)
}
```
效果

image.png

3.代码片

这个东西跟代码框其实差不多,只不过当一行的代码足够长时,代码框可以左右滑动,而代码片不会,代码片会在其包裹的内容上蒙上一层淡淡的底色。
语法

` 代码块 `

示例:

`
let gridMaterial = SCNMaterial() gridMaterial.diffuse.contents = UIImage(named: "art.scnassets/grid.png") 
plane.materials = [gridMaterial]
`

效果

image.png

4.无序列表

无序列表的实现方式很简单,有三种:分别在文字前面加上 * 、- 、+ 中的其中一种即可。注意符号需要与文字空一个空格。
语法

* 文字
- 文字
+ 文字

示例:

* 无序列表1
- 无序列表2
+ 无序列表3

效果

image.png

5.有序列表

有序列表的实现是 ‘数字加点’,后面接上需要描述的文字即可,注意需要要与文字空一个空格。
语法

数字编号. 文字

示例(有序无序列表嵌套):
注意: 如需列表嵌套,上一级和下一级之间敲三个空格即可

1. 一级有序列表
   * 二级有序列表

效果

image.png

6.引用

我们在写文章时,有时需要借鉴、引用他人的文字或论证,这时引用就变得有必要了。引用语法很简单,一个 > 符号就可以。引用可以多层嵌套,每进一层,多加一个>就可以了,可以加很多层。
语法

> 所引用的内容
>> 所引用的内容

示例:

>凤兮凤兮归故乡,遨游四海求其凰
>>凤凰鸣矣,于彼高岗;梧桐生矣,于彼朝阳
>>>大河之剑天上来

效果

image.png

7.强制换行

markdown编辑器下直接回车,预览时换行是显示不了的。这时就需要强制换行了。
语法

<br>

示例:

第一行文字
<br>
第二行文字

效果图:略

8.转义字符

当我门需要直接打印出每个带有图书意义的字符时,就需要一个转义字符,讲那个特殊字符转换为普通字符,这时才能打印。比如代码框符号```,引用符号>等。这个转义字符就是反斜杠 \。
语法

\需要转义的字符

示例:

\```
\>
\<br>

效果

image.png

9.链接

当我们的文章有需要跳转其他资源的需求时,此时就需要一个链接。链接的标记格式为[需要跳转资源的文字描述](http资源地址),这样我们点击文字描述,就能直接跳转到相应的资源。
语法

[需要跳转资源的文字描述](http资源地址)

示例:

你可以在 [简书](http://www.jianshu.com/) 上写出优美的文章

效果:

image.png

10.插入图片

插入图片的语法跟链接差不多,多一个!,标记格式为![想要显示的图片名](图片地址)
语法

![想要显示的图片名](图片地址)

示例:

![美女小姐姐](http://upload-images.jianshu.io/upload_images/2978034-fd317044c63cd724?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240)

效果

image.png

11. 字体

字体语法可以组合起来使用。
语法:

**加粗**
*倾斜*
_倾斜_
***斜体加粗***
~~加删除线~~
~~*加删除线的倾斜*~~

示例:

**这是加粗的文字**
*这是倾斜的文字*
_这是倾斜的文字_
***这是斜体加粗的文字***
~~这是加删除线的文字~~
~~*这是加删除线的倾斜文字*~~

效果:

image.png

12. 分割线

语法:

三个或以上的*或-都可以

示例:

***
---
************
------

效果:

image.png

二、Markdown语法进阶篇

1. 上标、下标

语法一 :
Markdown兼容HTML的语法,所以使用HTML中上下标的语法即可。

上标: <sup>文字</sup>
下标: <sub>文字</sub>

语法二 :
这种语法有一定兼容性问题,在某些平台上可能显示不出来,比如在掘金上以这种方式实现的商标,没有任何效果,以这种方式实现的下标则变成了删除线。而这种语法在简书上的显示都符合预期。

上标: ^文字^
下标: ~文字~

示例:

水的分子式为:
H<sub>2</sub>O
H~2~O
圆的面积为:
πr<sup>2</sup>
πr^2^

Tencent^这是一个商标TM^

效果:

image.png

2. 表格

语法:

第二行分割表头和内容。
- 有一个就够了,为了看起来整齐,可以随意添加。
文字对其方式: 默认居左
-两边加:表示文字居中
-右边加:表示文字居右


| 表头 | 表头 |
| ------ | ------ |
| 内容 | 内容 |
| 内容 | 内容 |

示例:

| 公司 | 坐标 | 创始人 |
| ------ | ------: | :------: |
| 腾讯 | 深圳 | Pony Ma |
| 阿里 | 杭州 | Jack Ma  |

效果:

image.png

3. 注释

所谓注释,也可以说是草稿,就是不希望显示出来给别人看到的东西。这样吐槽、心情和一些不成熟的想法都可以以这种方式记录。等你时间充裕,好好整理补充一下这些东西,就可以公开发表出来了。
注意⚠️: 如果是换行写的话,前面有四个空格。

语法:

[^_^]: 需要注释的内容
[>_<]: 需要注释的内容
[>_>]: 需要注释的内容
[·-·]: 需要注释的内容
[@_@]: 需要注释的内容

示例:

[^_^]:
    这是草稿,仅作者可见,发表出来的文章里看不到。
    这是草稿
[>_<]: 这是草稿

效果:
略。界面上啥也不会显示。

本文尚未提到的语法,基本也是平时很难用到的语法,有时间再整理。
未完待续....

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

推荐阅读更多精彩内容

  • Android 自定义View的各种姿势1 Activity的显示之ViewRootImpl详解 Activity...
    passiontim阅读 171,858评论 25 707
  • 关于简书 Markdown Markdown 语法的目标: 成为一种适用于网络的书写语言。本文的目的:使读者...
    白老师课堂阅读 15,415评论 24 177
  • 发现 关注 消息 iOS 第三方库、插件、知名博客总结 作者大灰狼的小绵羊哥哥关注 2017.06.26 09:4...
    肇东周阅读 12,066评论 4 62
  • 第三堂课作业: 第三堂课程结束,北宸老师让我们分享一下自己所接触到或者了解到的关于建筑和科技行业里面,认为好的一些...
    过后123阅读 418评论 0 0
  • 轰轰烈烈是假,平平淡淡才是真。 这是谁说的歪理,让我作为真理信仰了好多年。如果一场爱情没有心急火燎的渴望,没有一日...
    巴彦阅读 1,327评论 2 3