markdown语法


  学习markdown?当然是为了做做笔记,脑子不好就只能动动手指啦。
  以往做笔记是用的OneNote,但是一段事件下来,发现记在OneNote上的东西非常多,而且不方便查找。OneNote的Copy技能太强大了有木有。在现在日常开发节奏这么快的环境下,遇到不懂的技术基本都是度娘,google一顿操作,然后过两天忘了。悲哀呀,日常学习成果就这样遗忘在时间的角落了。本人表示很愤怒,本来就是我的,凭什么丢掉。
  脑子不好只有靠别的弥补了,于是有了学习 markdown 并撰写博客的动机了。给自己的学习增加一个知识整理的过程,一个技术沉淀的载体。


目录

[toc]


1:标题

标题有六个级别,用 # 号来表示,有以下六个级别。

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

一级标题

二级标题

三级标题

四级标题

五级标题
六级标题

2:列表

markdown中里列表也有“有序”和“无序”之分。
在文字前加上 - * + 就是无序列表,但是效果一样的,
加上数字如 1. 2. 3. 便是有序列表。
注:-、1. 和文本之间要保留一个字符的空格

- 无序列表1
- 无序列表2

* 无序列表1
* 无序列表2

+ 无序列表1
+ 无序列表2
  • 无序列表1
  • 无序列表2
  • 无序列表1
  • 无序列表2
  • 无序列表1
  • 无序列表2
1. 有序列表1
2. 有序列表2
  1. 有序列表1
  2. 有序列表2

3:表格

语法:

  • 列:用 | 区分每列。
  • 行:只能区分表头和表单内容,用 - 区分
  • 对齐:再相应的方向上,用 :表示,如:
    ----- 默认对其:左对齐
    ----: 为右对齐
    :---- 为左对齐
    :---: 为居中对齐
| column | column | column | column |
| ---: | :----: | :----- | ---- |
|   row  | row | row | row |
|   row  | row |     | row |
|   row  | row | row |     |

column column column column
row row row row
row row row
row row row

4:链接

markdown中链接有两种:参考式、行内式。
链接的话可以是本地资源路径,相对路径和绝对路径都是可以的

行内式语法:[显示文本](链接地址 "title")
链接弟子可以用<>包裹,也可以不用,效果式一样的
title属性的效果是鼠标悬浮到显示文本上会有提示信息,跟html是一样的。不想要的话,可以省略该属性。而属性值用单引号''、双引号“”、小括号()等任意一个符号包裹都是可以的,可以试一下。

参考式语法:
[显示文本][引用标识]
[引用标签]: 链接地址 "title"
参考式语法其实就是先定义好了再使用,多了个引用标签这样,方便我们集中管理引用,万一引用的资源url变了,方便修改了。
另外需要注意的是,参考式的链接地址和行内式的链接地址式不一样的,行内式的链接地址需要用小括号包裹,而参考式是不需要小括号的。

行内式链接(有title):[这是百度的链接](www.baidu.com "百度")
行内式链接(无title):[这是百度的链接](www.baidu.com)

行内式链接(符号:<>):[这是百度的链接](<www.baidu.com> "百度")
行内式链接(符号:''):[这是百度的链接](<www.baidu.com> '百度')
行内式链接(符号:()):[这是百度的链接](<www.baidu.com> (百度))

行内式链接(有title): 这是百度的链接
行内式链接(无title): 这是百度的链接
行内式链接(符号:''): 这是百度的链接
行内式链接(符号:""): 这是百度的链接
行内式链接(符号:()): 这是百度的链接

参考式链接:[这是百度的链接][mark-1]
参考式链接:[这是百度的链接][mark-2]
参考式链接:[这是百度的链接][mark-3]

[mark-1]: www.baidu.com "这是百度链接"
[mark-2]: www.baidu.com '这是百度链接'
[mark-3]: www.baidu.com (这是百度链接)

参考式链接:这是百度的链接
参考式链接:这是百度的链接
参考式链接:这是百度的链接


5:图片

markdown中图片也有两种:参考式、行内式。这和链接是一样的
路径的话可以是本地资源路径,相对路径和绝对路径都是可以的

行内式语法:[图片上传失败...(image-ef80a8-1535444198905)]
对比链接,也就多了个感叹号。

参考式语法:
![失效显示文本][引用标识]
[引用标签]: 图片地址 "title"
图片的参考式语法和链接的区别也是多了一个 ! 其他都是一样的。

行内式图片:
![这是百度的图片](http://upload-images.jianshu.io/upload_images/11623065-9c29e8a9c85494eb.jpg?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240 "悬浮提示信息:message!!!")

行内式图片:


这是百度的图片
参考式图片:
![这是百度的图片][mark-img-1]
![这是百度的图片][mark-img-2]

[mark-img-1]:http://e.hiphotos.baidu.com/zhidao/wh%3D450%2C600/sign=08ce1447ceef76093c5e919b1bed8ffa/622762d0f703918fa4d62d10543d269758eec4e0.jpg "这是百度的图片"
[mark-img-2]:http://img2.a0bi.com/upload/ttq/20140704/1404444786734_middle.jpg "这是百度的图片"

参考式图片:


这是百度的图片
这是百度的图片

这是百度的图片
这是百度的图片

建议:行内式和参考式其实更应该使用参考式,因为图片地址和链接地址这种东西都是非常长的字符串,嵌入到文本内容当中很不优雅,会用凌乱的感觉,而使用参考式则没有这个问题,另外还可以统一管理url地址。也不用担心引用标签重复的问题。


6:代码块

写技术博客,最常用到的就是代码引用,markdown用 ` 来表示引用代码。

语法:

  • `单行引用`
  • ``` 多行引用
    多行引用
    多行引用
    ```

单行代码引用:`LOGGER.info("message");`

多行代码引用:

@RunWith(SpringRunner.class)
@SpringBootTest
public class DemoApplicationTests {

    private static final Logger LOGGER = LoggerFactory.getLogger(DemoApplicationTests.class);

    @Test
    public void contextLoads() {

        LOGGER.info("message");

    }

}

7:区块引用

语法:用 > 来表示区块引用,有多少级就加多少个。只要是连续的,貌似没有限制。如果要另外增加相邻的同级,要空一行。

>一级引用
>>二级引用
>>>三级引用
>>>>四级引用
>>>>>五级引用

>>>>>>六级引用
>>>>>五级引用
>>>>>>>七级引用

>一级引用

一级引用

二级引用

三级引用

四级引用

五级引用

六级引用

五级引用

七级引用

一级引用


8:特殊字符

特殊markdown本质上其实是和html一样的语言,因此关于特殊字符和转移和html也是一样的,可以直接用编码展示特殊字符,参照HTML ASCII 参考手册

例如这些实体:
&#33;   &#34;   &#35;   &#36;   &#38;   &#60;   &#62;   &#169;  &#174;  &#165;

! " # $ & < > © ® ¥


9:分割线

分割线可以用三个以上的 *- 来表示。

------
被分割的内容
******

被分割的内容



10:文字处理

字体处理常用的就是高亮,颜色和加粗了,当然还有下划线,斜体,这些,删除一般都不会用了。颜色的话简书貌似也不支持,尚极简风格。不然的话可以用<font>标签来设置

  • 高亮:用 == 包裹,高亮简书不支持,建议用 ` 代替
  • 斜体:用 * 包裹
  • 加粗:用 ** 包裹
  • 下划线:用 ++ 包裹
  • 删除:用 ~~ 包裹
  • 段首空两格:用 &#8195;&#8195;
==高亮==
*斜体*
**加粗**
++下划线++
~~删线~~

&#8195;&#8195;段首空两格
段首空两格,段首空两格,段首空两格。

==高亮==
斜体
加粗
++下划线++
删线

  段首空两格
段首空两格,段首空两格,段首空两格。


11:生成目录

使用[toc]就可以了,但是简书不支持。有道和csdn是可以支持的。


12:参考文献

参考文献的表示方式叫脚注或者尾注
语法:[^标签]
其实这个标签只是代码方便查看而给予的一个自定义方式,最终呈现在文本上的都是按全篇顺序排好序的文献引用。而且参考文献里欸包会自动加载到文档最魔为,分隔符是无法分割的

XXXXX[^1] XXXXXXXXXXXXXXXX,
XXXXX[^hello] XXXXXXXXXXXXXXXX,
XXXXX[^正经引用] XXXXXXXXXXXXXXXX,
XXXXX[^大学论文] XXXXXXXXXXXXXXXX

[^1]: 一个很普通的参考文献。
[^hello]: 这个很可能是自己的原创。
[^正经引用]: 某个知名博主的发表吧,引用一下。
[^大学论文]: 某某教授的论文,要认真标注好。

XXXXX[1] XXXXXXXXXXXXXXXX,
XXXXX[2] XXXXXXXXXXXXXXXX,
XXXXX[3] XXXXXXXXXXXXXXXX,
XXXXX[4] XXXXXXXXXXXXXXXX



  1. 一个很普通的参考文献。

  2. 这个很可能是自己的原创。

  3. 某个知名博主的发表吧,引用一下。

  4. 某某教授的论文,要认真标注好。

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

推荐阅读更多精彩内容