写在前面:
- 目的:这个文档自身就是使用 Markdown 编写的。Markdown 允许你通过编写易读、易写的富文本格式,然后很方便就可以转换成有效的 HTML。
- 本教程以一般方案的书写习惯为便。致力于打造最全面的md语法教程,若发现错漏欢迎加QQ群联系本人
- 应用的软件:以 XXX 软件的语法为标准,其他软件平台部分语法规范不一样的话,部分项将不能显示,请知悉。
- 编写整理本教程耗费作者很多心血,转载请保留出处,欢迎加QQ群
123456
交流,并有各pc,安卓,mac各平台md相关软件和实用资料的下载。后期打算制作视频教程哦-- 感谢原创作者和软件开发者的无私共享。
- 本软件全程使用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(第一项数字一定要为“520”)
- 列表项2(其实我前面的标的数字是“201314”)
- 列表项3(其实我前面的标的数字是“20161130”)
【说明】后面的不必在意数字从小到大的排序,显示时会自动排序,有智能的乱序纠正功能,非常贴心。数字前面加了空格,排序会变成罗马数字形式。
-
无序列表:
【语法】文字前面加 星号空格*(空格)
或 短横空格-(空格)
或 加号+(空格)
表示
【示例】无序单层列表
-
列表项 1(前面未加空格是 实心点)
-
列表项 2(前面未加空格是 实心点)
-
多重列表:
【语法】单层列表项缩进1个空格就可以往后面叠加子层的列表
【示例】
- 首层列表项(有序)
- 第二层列表项1(嵌套的列表可以是有序的 )
- 第二层列表项2(格式和正常的有序、无序列表没有差异)
- 第三层列表项1
- 第三层列表项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://i-blog.csdnimg.cn/blog_migrate/b06e32271ecae17b0d78daf4c0cfa73a.jpeg "鼠标悬停显示文字"
代码块
-
行内(内联)代码
【语法】 使用内容
表示行内 代码块。即 在文字左右使用反引号包含(键盘数字“1”前面的波浪号大写状态时能打出)。
【示例】
各位同学晚上好,我是你们敬爱的送晴老师,这次让我们来聊聊 html5
,本期我们邀请了重量级嘉宾马化腾
先生给我们讲解,大家掌声欢迎……
【说明】
和标签/关键词
的效果差不多,还可用于如按键Ctrl+F4
,字母B
,单词F**K
、短句Are you ok?
等诸多行的应用场景。能起到强调区分的作用。
-
定义型代码块
【语法】:(4空格)
,左侧加一个可见的英文冒号和4个不可见的空格)
【示例】
: 这是代码块的定义(左侧有一个可见的英文冒号和四个不可见的空格)
-
段落文本代码块
【语法】每行缩进4个空格或 1个 Tab
表示
【示例】方法一
这是一个代码块,此行左侧有四个不可见的空格。
这是代码块,会自动添加行号,注意要与前面文字空行,
不然没有引用效果,就是这么简单,非常实用呀。
作者:陆磊
链接:https://www.jianshu.com/p/86e7fa33de8e
來源:简书
简书著作权归作者所有,任何形式的转载都请联系作者获得授权并注明出处。