标准md语法教程- Markdown从入门到精通(上)

标准md语法教程- Markdown从入门到精通 (送晴编写)

tags: 送晴 Markdown 语法教程

写在前面:

  1. 目的:这个文档自身就是使用 Markdown 编写的。Markdown 允许你通过编写易读、易写的富文本格式,然后很方便就可以转换成有效的 HTML。
  2. 本教程以一般方案的书写习惯为便。致力于打造最全面的md语法教程,若发现错漏欢迎加QQ群联系本人
  3. 应用的软件:以 XXX 软件的语法为标准,其他软件平台部分语法规范不一样的话,部分项将不能显示,请知悉。
  4. 编写整理本教程耗费作者很多心血,转载请保留出处,欢迎加QQ群123456交流,并有各pc,安卓,mac各平台md相关软件和实用资料的下载。后期打算制作视频教程哦-
  5. 感谢原创作者和软件开发者的无私共享。
  6. 本软件全程使用md语法书写,全部中文表述,充分考虑了国内的小白用户。

MD入门语法教程

标题

  • 主标题:

【语法】主标题文字 空行 ==(两个及以上)
【示例】
主标题文字(最高阶标题)
==
【说明】相当于H1大纲标题效果,一般在首行应用和表示

  • 副标题:

【语法】副标题文字 (空行) ---减号两个及以上
【示例】
副标题文字(第二阶标题)
--
【说明】相当于H2大纲标题效果

  • H1~H6大纲标题

【语法】#(空格)文字#(空格)文字 (空格)#) (1-6等级分别在文字前加对应数量#,后面的#为可选,不加效果也一样。
【示例】

大纲标题文字 H1(等同 主标题)

大纲标题文字 H2(等同 副标题)

大纲标题文字 H3

大纲标题文字 H4

大纲标题文字 H5
大纲标题文字 H6

####### 大纲标题文字 H7(最多6阶)

【说明】最多6个等级的大纲标题,后面加上同等数量“(空格)#”效果也一样

标签

【语法】TAGS:内容 或直接标签:内容 ,即 在编辑区任意行的列首位置输入tags/标签:关键词1 关键词2 , 多个用空格隔开。
【示例】
标签: 教程 Markdown
或者
Tags: 教程 2016年 重要的

目录(大纲)导航

【语法】 在段落中填写 [TOC] (toc小写也可以)以显示各标题为结构的目录(大纲)导航。
【示例】

[TOC]

强调或突出

  • 斜体

【语法】_斜体_*斜体* 在文字两边加 单下底线 或 单星号
【示例】 斜体斜体

  • 粗体

【语法】__粗体__**粗体** 在文字两边加 双下底线 或 双星号
【示例】 粗体粗体

  • 删除线

【语法】~~删除线~~ 在文字两边加 双波浪号
【示例】这是带有 删除线 的文字
【说明】快速记忆:单斜双粗两波删

  • 下划线

【语法 】 在空白行下方添加三条“-”横线。(前面讲过在文字下方添加“-”,实现的2级标题)
【示例】
这是---下划线---
你看到了吗?

段落与分割

  • 普通段落

【语法】用空行分隔,连着多个空行也是一个效果,只能空一行的间距。
【示例】

这是首行文字

这是尾行文字,实际中间我空了7行,但还是只显示空了一行的效果。

【说明】有的语法要用到空行才有效果(如主标题,列表),不空行的话默认又是会跟随上面语法特征(如表格语法前面就要空行后才有效果),应用时多加注意。

  • 水平分割线

【语法】3个及以上的 星号***或 减号---或 下底线___来表示。

【示例】




【说明】建议只固定选用一个,如三个星号***为标准,用减号---容易和副标题搞混。

  • 强制换行

【语法】在行尾输入两个空格
【示例】(好像没有效果)
这句话
不会
换行

这句话

换行(这里有很多个文字这里有很多个文字这里有很多个文字这里有很多个文字这里有很多个文字这里有很多个文字这里有很多个文字这里有很多个文字这
里有很多个文字这里有很多个文字这里有很多个文字这里有很多个文字)

MD中级语法教程

链接

  • 网页链接(内联风格)

【语法】 [链接文字](http://链接地址)"(空格)鼠标悬停显示文字(可选)","(空格)鼠标悬停显示文字"非必须项,在pc浏览器中能看到效果,手机移动端因无鼠标效果无法直接体现。
【示例】这是去往 本人博客 的链接。

  • 链接的快速定义

【语法】

前面文档中引用链接的语法为:
[链接文字][id]
前后id要匹配一致,一般为数字,这样可以在文档的其他任意地方快速插入这个链接。

后面定义链接的语法为:
[id]:(空格)http://链接地址(空格)"鼠标悬停显示文字(可选)"
后面的语法必须在列首并单独一行,适合前期不知道网址,后面再加入的情况。

【示例】
大家去访问MarkdownX 官方网站吧,这个也是MDX官网哦。

  • 链接的自动展示

你可以直接输入链接地址,它可以直接识别这个链接。
http://markdownx.ryeeeeee.com

  • Email 链接

【语法】直接<邮箱号地址>即可
【示例】作者的 email 链接.

列表

  • 有序列表:

【语法】直接数字加英文句点加空格(最多三个空格)和文字
【示例】有序单层列表

  1. 列表项1(第一项数字一定要为“520”)
  2. 列表项2(其实我前面的标的数字是“201314”)
  3. 列表项3(其实我前面的标的数字是“20161130”)

【说明】后面的不必在意数字从小到大的排序,显示时会自动排序,有智能的乱序纠正功能,非常贴心。数字前面加了空格,排序会变成罗马数字形式。

  • 无序列表:

【语法】文字前面加 星号空格*(空格)或 短横空格-(空格)或 加号+(空格)表示
【示例】无序单层列表

  • 列表项 1(前面未加空格是 实心点)

  • 列表项 2(前面未加空格是 实心点)

  • 多重列表:

【语法】单层列表项缩进1个空格就可以往后面叠加子层的列表
【示例】

  1. 首层列表项(有序)
  2. 第二层列表项1(嵌套的列表可以是有序的 )
  3. 第二层列表项2(格式和正常的有序、无序列表没有差异)
  4. 第三层列表项1
  5. 第三层列表项2
    1.第四层列表项1
    1.第五层列表项2
  • 首层列表项第四层列表项2(无序)
  • 嵌套的列表可以是无序的
    • 这个嵌套的列表项有4个空格的缩进,因为它的父列表项自身就带有2个空格的缩进
    • 还允许更多层的嵌套,反正在前面一层中再空行后加两空格就行
    • 列表项 3(前面加了 空格是空心,且会后置)
      • 列表项 4(前面加了 空格是空心,且会后置)

引用

  • 文字引用

【语法】段落前面添加大于号和空格> (空格),就能够形成引用段落。
【示例1】单层引用

青松 (陈毅)
大雪压青松,青松挺且直。
要知松高洁,待到雪化时。

【示例2】多层引用

这是第一层的文字引用

这是第二层嵌套的引用

这是第三层的嵌套的引用

第9层,第N层就在前面添加N个>(空格)表示

添加影像附件

  • 插入图片

【语法】使用 ![图片描述](图片网络/本地图片地址)(空格)“鼠标悬停显示文字(可选)”

【示例】


我的头像
我的头像
  • 图片链接的定义

【语法】

  前面文档中引用的语法:
![图片描述]本地/网络图片地址 "鼠标悬停显示文字(可选)"

前后id要匹配一致,一般为数字,这样可以在文档的其他任意地方快速插入这张图片。
这是一张本地图:/url/to/img.jpg


   后面定义链接的语法为:
![图片描述][id]:本地/网络图片地址 "鼠标悬停显示文字(可选)"
后面的语法必须在列首并单独一行

这是两张图片是相同的![我的图片][id],这张是![我的同胞兄弟][id]照片。

【示例】
[id]: https://www.zybuluo.com/static/img/my_head.jpg "鼠标悬停显示文字"

代码块

  • 行内(内联)代码

【语法】 使用内容 表示行内 代码块。即 在文字左右使用反引号包含(键盘数字“1”前面的波浪号大写状态时能打出)。

【示例】
各位同学晚上好,我是你们敬爱的送晴老师,这次让我们来聊聊 html5,本期我们邀请了重量级嘉宾马化腾先生给我们讲解,大家掌声欢迎……
【说明】
标签/关键词的效果差不多,还可用于如按键Ctrl+F4,字母B,单词F**K、短句Are you ok?等诸多行的应用场景。能起到强调区分的作用。

  • 定义型代码块

【语法】:(4空格),左侧加一个可见的英文冒号和4个不可见的空格)
【示例】

: 这是代码块的定义(左侧有一个可见的英文冒号和四个不可见的空格)

  • 段落文本代码块

【语法】每行缩进4个空格或 1个 Tab表示
【示例】方法一

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

推荐阅读更多精彩内容