markdown学习笔记1.0
概述
1、兼容HTML
HTML是一种发布的格式,Markdown是一种发布的格式。Markdown 语法在 HTML 区段标签间是有效的。
Markdown 的生成器有足够智能,不会在 HTML 区块标签外加上不必要的
标签。
例:
这是一个普通段落。
<table>
<tr>
<td>1</td>
</tr>
</table>
这是另一个普通段落。
1.1表格
(作者:热心市民123
链接:https://www.jianshu.com/p/59aaa82ae723
來源:简书
简书著作权归作者所有,任何形式的转载都请联系作者获得授权并注明出处。)
表格前一定要空一行
在每个单元格文字的两端加上一个竖线“|”。
第二行控制单元格文本的位置,第二行控制文本的位置,规则如下:默认是靠左,用英文冒号“:”来调整,两边都有冒号,而且冒号中间至少有一个减号“-”的时候表示居中(当然也可以通过增加“-”号的数目来使它们对齐,更好看一点,但效果是一样的);冒号在右边而且冒号之前至少有一个-的时候表示靠右,其它情况则是靠左。注意,冒号“:”一定要为英文的,不可为中文的冒号。如:
第一季度 | 第二季度 | 第三季度 | 第四季度 |
---|---|---|---|
20% | 30% | 25% | 40% |
2、特殊字符自动转换
在 HTML 文件中,有两个字符需要特殊处理: < 和 & 。 < 符号用于起始标签,& 符号则用于标记 HTML 实体,如果你只是想要显示这些字符的原型,你必须要使用实体的形式,像是 &lt和 &。
注意:code 范围内,不论是行内还是区块, < 和 & 两个符号都一定会被转换成 HTML 实体,这项特性让你可以很容易地用 Markdown 写 HTML code ;而HTML 语法中,要把所有的 < 和 & 都转换为 HTML 实体,才能在 HTML 文件里面写出 HTML code。
二、区块元素
1.段落和段行
2.标题
Markdown 支持两种标题的语法,类 Setext 和类 atx 形式。
类 Setext :是用底线的形式,利用 = (最高阶标题)和 - (第二阶标题)
例:This is an H1
=============
This is an H2
类 atx :在行首插入 1 到 6 个 # ,对应到标题 1 到 6 阶
例:
这是 H1 #
这是 H2 ##
这是 H3 ######
3.区块引用
在每行的最前面加上 > ;在整个段落的第一行最前面加上 > ;区块引用可以嵌套(例如:引用内的引用),只要根据层次加上不同数量的 > ;引用的区块内也可以使用其他的 Markdown 语法,包括标题、列表、代码区块等;
例:
这是一个标题。
- 这是第一行列表项。
- 这是第二行列表项。
给出一些例子代码:
return shell_exec("echo markdown_script");
4.列表
无序列表:使用星号、加号或是减号作为列表标记
有序列表:使用数字接着一个英文句点(数字的正确性不用在意)
例:
-
好
-
哈
注意:列表项目可以包含多个段落,每个项目下的段落都必须缩进 4 个空格或是 1 个制表符:;列表要放代码区块的话,该区块就需要缩进两次,也就是 8 个空格或是 2 个制表符
5.代码区块
缩进 4 个空格或是 1 个制表符;一个代码区块会一直持续到没有缩进的那一行(或是文件结尾)。
6.分割线
在一行中用三个以上的星号、减号、底线来建立一个分隔线,行内不能有其他东西。也可以在星号或是减号中间插入空格:
三、区段元素
1.链接
链接文字都是用 [方括号] 来标记。
链接内容定义的形式为:
方括号(前面可以选择性地加上至多三个空格来缩进),里面输入链接文字
接着一个冒号
接着一个以上的空格或制表符
接着链接的网址
选择性地接着 title 内容,可以用单引号、双引号或是括弧包着
2.强调
Markdown 使用星号(*)和底线(_)作为标记强调字词的符号,被 * 或 _ 包围的字词会被转成用 标签包围,用两个 * 或 _ 包起来的话,则会被转成<strong>
例:
single asterisks
single underscores
double asterisks
double underscores
会转成:
single asterisks
single underscores
double asterisks
double underscores
注意:*和_两边不能都有空白,否则会被当作普通符号
3.代码
标记一小段行内代码,可以用反引号把它包起来(`)
4.图片
行内式:
[图片上传失败...(image-94cbbd-1535548389219)]
[图片上传失败...(image-4ccdee-1535548389219)]
详细叙述如下:
一个惊叹号 !
接着一个方括号,里面放上图片的替代文字
接着一个普通括号,里面放上图片的网址,最后还可以用引号包住并加上 选择性的 'title' 文字。
参考式:
Alt text「id」是图片参考的名称,图片参考的定义方式则和连结参考一样:
四、补充
1.反斜杠
Markdown 支持以下这些符号前面加上反斜杠来帮助插入普通的符号:
\ 反斜线
` 反引号
- 星号
_ 底线
{} 花括号
[] 方括号
() 括弧
井字号
- 加号
- 减号
. 英文句点
! 惊叹号
2.自动链接
支持以比较简短的自动链接形式来处理网址和电子邮件信箱,只要是用方括号包起来, Markdown 就会自动把它转成链接。
五、Markdown 免费编辑器
1.Windows 平台
Markdownpad
Markpad
2.Linux 平台
Retext
Mac 平台
Mou
3.在线编辑器
Markable.in
Dillinger.io
4.浏览器插件
MaDe(Chrome)