MarkDown基础语法

一、概述

宗旨

Markdown 的目标是实现「易读易写」。

可读性,无论如何,都是最重要的。一份使用 Markdown 格式撰写的文件应该可以直接以纯文本发布,并且看起来不会像是由许多标签或是格式指令所构成。
Markdown 的语法全由一些符号所组成,这些符号经过精挑细选,其作用一目了然。比如:在文字两旁加上星号,看起来就像*强调*。Markdown 的列表看起来,嗯,就是列表。Markdown 的区块引用看起来就真的像是引用一段文字,就像你曾在电子邮件中见过的那样。

兼容HTML

MarkDown语法的目标是: 成为一种适用于网络的书写语言。
Markdown 不是想要取代 HTML,甚至也没有要和它相近,它的语法种类很少,只对应 HTML 标记的一小部分。

具体更多特性见Markdown 语法说明 (简体中文版),感谢作者团队的无私贡献。

语法简单

MarkDown相比于HTML只有少量的语法,很快就能上手写一些简单的md文件。接下来开始学习之旅~


二、基础用法

1、标题

Ⅰ、类 Atx 形式

在想要设置为标题的文字前面加#来表示。一个#是一级标题,二个#是二级标题,以此类推,支持六级标题。

Note:标准语法一般在#后面跟一个空格,在两个#行之间空一行代表是换行。不过并不是严格要求,开始写尽量按标准来较好。

eg:

# 一级标题
## 二级标题

result:

一级标题

二级标题

Ⅱ、类 Setext 形式

底线的形式,利用 =(最高阶标题)和 -(第二阶标题),两种符号数量不小于1。

Note: -=上一行必须有内容才能解析为标题。

eg:

一级标题
=
二级标题
------------

result:

一级标题

二级标题

2、字体

  • 粗体: **<内容>**

  • 斜体: *<内容>*

  • 斜粗体: ***<内容>***

  • 删除线: ~~<内容>~~

eg:

**粗体**
*斜体*
***斜粗体***
~~删除线~~

result:

粗体
斜体
斜粗体
删除线

3、引用

在引用的文字前加>即可,引用可以嵌套。可以用来引用某处的内容或者提供背景阴影效果,我经常用后者的功能...

eg:

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

result:

一级引用

二级引用

三级引用

4、分割线

三个或者三个以上的-或者*。

Note: 如果用-,上一行有内容的话会被解析为类Setext形式的二级标题!

eg:

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

result:



5、代码

  • 单行代码: `<代码>`
  • 多行代码: ```<代码>```

Note: 多行的情况下,可在第一个```后面加上语言名称,例如下例中的c

eg:

  • 单行:
`int a=233;`
  • 多行:
(``` c)
#include <stdio.h>
int main(int agc, char *agv[])
{
    printf("hello mardown!\n");
    return 0;
}
(```)

Note: 此处为了排版需要,加了括号,实际使用中去掉即可。

result:

  • 单行:

int a = 233;

  • 多行:
#include <stdio.h>
int main(int agc, char *agv[])
{
    printf("hello mardown!\n"); 
    return 0;
}

三、中级用法

1、超链接

用法为:[URL名称] (URL地址 "title")

Note: [ ] 与 ( ) 之间没有空格,title是URL的标题,当鼠标移到超链接上时显示的内容。title可加可不加。

eg:

[Jason416's Blog](https://jason416.tk)

result:

Jason416's Blog

2、 图片

用法为:![图片alt] (图片地址 ''图片title'')

Note: [ ] 与 ( ) 之间没有空格;图片alt就是显示在图片下面的文字,相当于对图片内容的解释;图片title是图片的标题,当鼠标移到图片上时显示的内容。title可加可不加。

eg:

![图1. Miku](https://upload-images.jianshu.io/upload_images/12843237-fdd7d0324ba678bc.jpg?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240 "Miku's picture")

result:


图1. Miku

Note: 貌似简书上直接这样写,会提示图片上传失败~,光标定位到这,点上面工具栏的上传就好。会自动生成对应的图片URL链接,这个时候可以修改其他内容,规则跟上述一致。

3、列表

  • 无序列表
    用 - + * 中的任何一个字符都行,关键字跟内容之间要有一个空格。
  • 有序列表
    数字加上.

无序:

- 列表内容1
+ 列表内容2

有序:

1. 列表内容
2. 列表内容

result:
无序:

  • 列表内容1
  • 列表内容2

有序:

  1. 列表内容
  2. 列表内容

4、列表嵌套

用法为:上一级和下一级之间敲三个空格。有序和无序类似,可以穿插使用。

eg:

- 一级列表
   1. 二级列表

result:

  • 一级列表
    1. 二级列表

5、表格

语法为:
| 表头1 | 表头2 | 表头3 | ...
| -: | :-: | - | ...
内容1 | 内容2 | 内容 3| ...

第二行为表格格式控制行。
-表示列表内容,有一个便可;
:可标记文字对齐方式,放在-左边就是左对齐,其他类推,默认居中。

Note: -:之间没有空格!两边的| 可以省略。默认对齐方式各平台有差异...

eg:

| 姓名 | 身高 | 年龄 |
| -: | :-: | - |
| 李四 | 175 | 18 |

result:

姓名 身高 年龄
李四 175 18

四、总结与致谢

经过在简书和自己博客上倒腾了,发现MarkDown解析器有些细微差别。比如对>的渲染效果都不一样,好像是hexo主题里的解析脚本应该跟简书的不太一样。不过大体效果是类似的。后期有时间再去研究,先在简书上记录吧,毕竟我比较懒,爱玩游戏。(*_*) 233。
非常感谢互联网上的朋友门的文章,也感谢为MarkDown默默做工作的人们~ 因为奉献,世界更加美好。
Together, make the world better!

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

推荐阅读更多精彩内容

  • Markdown 简介 Markdown 是一种用来写作的轻量级标记语言, 用一些简单的标记, 来代替常见的排版格...
    高小原阅读 443评论 0 0
  • A、目录 1、斜体和粗体 2、分级标题 3、超链接3.1、行内式3.2、参考线3.3、自动链接 4、锚点 5、列表...
    侯工阅读 971评论 2 7
  • 本文转自@younghz 主要内容 Markdown是什么?谁发明了这么个东西?为什么要使用它?怎么使用?都谁在用...
    Wynter_Wang阅读 434评论 0 1
  • 用简短的一页纸介绍Markdown基本语法 Markdown语法与Markdown编辑器 Markdown是一种标...
    RoamWonder阅读 8,623评论 0 3
  • 风中夹带的气息很熟悉,秋天的味道越来越浓了,一到这个季节,我会安然的醉卧在它的怀里,贪婪的呼吸它那独有的安宁。我喜...
    冬藏青阅读 338评论 0 3