#Markdown | 我的Markdown语法指南

这只是写给我自己看的,方便忘了语法之后查询一下,嗯……没别的

1.我怎么会知道markdown的?

也没什么特别的,就是某一天突然在A某so的推送中看到了这么一个markdown编辑器,就寻思这玩意儿一听名字这么牛批,莫非又是一个装x利器?当时没在意,最近在家闲得慌,又开始琢磨起这么一档子事儿来。所以刚刚花了两个钟头研究了一下markdown的写作逻辑,确实挺好玩。

简单地说,markdown是一标记语言,意思就是,在编辑文本的时候,就用符号将文字的编辑效果标记出来,然后通过转码直接显示出这种效果,举个简单的栗子:

这学期我可能学了假习 呸吧!根本没学习

代码如下:
这学期我可能~~学了假习~~ 呸吧!根本没学习

所以看到了吧?通过几个符号和原文本,就能显示出不同的效果,这要比在word中先输入文本,后还要去找相关的显示效果要来得方便的多,尤其是这个划线效果,在word中要选中文本右键-字体来设置,这样操作成本就高了一大截。这也是markdown与word操作逻辑最大的区别!

2. 看了一小时markdown语法你还记得多少?

嗯……没多少了,下面我来简单罗列一下

2.0 目录

2.1 标题
2.2 列表
2.3 强调和突出
2.4 引用
2.5 显示代码
2.6 链接、email和图片
2.7 表格
2.8 总结

2.1 标题

效果:

一级标题

二级标题

三级标题

四级标题

五级标题
六级标题

代码如下:

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

2.2 列表

效果:

有序列表:

  1. 列表项一
  2. 列表项二
  3. 列表项三

无序列表:

  • 列表项一
  • 列表项二
  • 列表项三

代码如下:

有序列表:
1. 列表项一
2. 列表项二
3. 列表项三

无序列表:
- 列表项一
- 列表项二
- 列表项三

列表嵌套:

  • 列表项一
  • 列表项二
    • 子列表项一
    • 子列表项二
      1. 子子列表项一
      2. 子子列表项二
      3. 子子列表项三
    • 子列表项三
  • 列表项三

代码如下:

- 列表项一
- 列表项二
  * 子列表项一
  * 子列表项二
    1. 子子列表项一
    2. 子子列表项二
    3. 子子列表项三
  * 子列表项三
- 子列表三

注意:

1. 在代码中,列表项前的1.-后一定要加一个空格

2. 列表嵌套根据不同的编辑器有不同的语法,有的编辑器是用-----来表示二级和三级子列表

3. 一级无序列表默认的符号是实心圆,二级是空心圆

2.3 强调和突出

效果:

斜体

加粗

斜体加加粗

错误文本

斜体加粗的错误文本

代码如下:

*斜体*

**加粗**

***斜体加加粗***

~~错误文本~~

~~***斜体加粗的错误文本***~~

2.4 引用

效果:

哦,之前你们都看过了,这玩意儿就是引用

代码如下

>哦,之前你们都看过了,这玩意儿就是引用

嵌套引用:

一级引用

二级引用

三级引用

返回二级引用

返回一级引用

代码如下:

>一级引用
>>二级引用
>>>三级引用

>>返回二级引用

>返回一级引用

注意

在嵌套引用中我们可以看到,返回引用时候一定要<strong>加一个空行</strong>,用以结束当次引用。同样的,我们会发现在结束代码的时候通常会加一个空行,这都是起到结束当次标记的作用,不然的话在明文中是不会回车的。

2.5 显示代码

2.5.1 显示代码单句

效果

hello world!

代码如下:

`hello world!`

2.5.2 显示代码块

效果:

代码语句1  
代码语句2  
代码语句3  
……

代码如下:

```  
代码语句1  
代码语句2  
代码语句3  
……  
```  

2.5.3 内联代码(在代码中写代码)

效果:

`hello world!`

代码如下:

`` `hello world!` ``

注意
其实在标准markdown语句中,代码块的显示使用每行缩进四个空格来实现的,但在github flavored markdown中,开始用```/```来显示代码块。

2.6 链接、email和图片

2.6.1 链接

效果:

简书官网

代码如下:

内联风格:
[简书官网](http://www.jianshu.com/)

引用风格:
[简书官网][id1]
[id1]:http://www.jianshu.com/

2.6.2 email

效果:

如果有什么不懂的,可以向笔者的
email m17862701665@gmail.com 反馈

代码如下:

如果有什么不懂的,可以向笔者的
email <m17862701665@gmail.com> 反馈

2.6.3 图片

效果:

额......就不要在意这是朵什么花了

代码如下:

内联风格:
![](http://upload-images.jianshu.io/upload_images/5117745-bfe7ef4ee8ffdde4?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240)

引用风格:
![][id1]
[id1]:http://ww1.sinaimg.cn/large/a10d54e8ly1fdiza85ikjj20ku08zq55

<a name="2.7"></a>

2.7 表格

效果:

表格 表格项1 表格项2 表格项3
左对齐 居中对齐 默认左对齐 右对齐
1 2 3 4

代码如下:

|表格|表格项1|表格项2|表格项3|
|:----|:-------:|--------|-------:|
|左对齐|居中对齐|默认左对齐|右对齐|
|1|2|3|4|

注意
代码中的第二行用于规定表格中的对齐格式,冒号在左表示左对齐,冒号在右表示右对齐,两边都有表示居中对齐,没有冒号表示默认左对齐。
<a name="2.8"></a>

2.8 总结

好了,在日常码字的时候需要用到的也就这几种语法,之前我说不记得多少了显然是骗人的,我全记得哈哈哈哈……咳,以后有补充的话会在补充的。

3.这就是传说中的补充——html在markdown中的应用

前段时间在简书中查询markdown的相关语法的时候,无意间看到一篇文章说markdown作为基于html的标记语言,那么,html的部分标签和字符实体markdown应该也是支持的。
原文在此:如何在markdown中打出上标、下标和一些特殊符号
这篇文章给了我一些启发,我就顺便在本文中试了一试,结果发现,不论是标签还是字符实体,在平台间也有一些区别,但是这么多标签我也没办法一个一个试过来,所以这里只能笼统得说一下。

3.1 标签

我贴张图就行了

标签演示

笼统来说,只有格式化标签可以在markdown中显示

3.2 字符实体

字符实体到大部分都是支持的:↓↓↓

字符实体演示

更多的字符实体请参看:
W3school:html ISO-8859-1参考手册
以及
W3school:html ASCll参考手册

over

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

推荐阅读更多精彩内容

  • 为什么学习Markdown 自从搭建了 Hexo 博客之后,发现还有 Markdown 这种写文章的方法,想到以后...
    lifeColder阅读 20,086评论 10 216
  • *一、Markdown是什么 * Markdown是一种轻量级的标记语言,使用的标记语法非常简单,它可以使用纯文本...
    乘风破浪55阅读 929评论 0 2
  • 1. 斜体和粗体 代码: 显示效果: 这是一段斜体 这是一段粗体 这是一段加粗斜体 这是一段删除线 2. 分级标题...
    泊牧阅读 2,305评论 0 2
  • 关键字:170421、周五、倒计时50、濮阳 清晨起床摸索着雪莲送的高级砂锅,煮出来的粥很有蕴味儿,给小何炒的鸡腿...
    二石兄阅读 243评论 0 1
  • 看看下面的设计: 这种设计非常不错,图片撑满画面,旁边写上内容,加上上期设计的跳台,小跳台。是不是效果很赞。 但您...
    秦川_牛闪闪阅读 1,267评论 1 18