1.软件
2..Markdown排版,语法
简单语法帮助
1 | Quick Markdown --------- 快速Markdown |
Markdown 折叠
其实这也是通过html
语法实现的功能,你可以测试一下(拒绝IE,它不支持):
我有些话想跟你说
等等,让我想想是什么话。
哎呀,忘记了。
实现上述折叠效果的代码如下:
1 | <details> |
Markdown插入表格
终于是一个Markdown本身就支持的功能了。表格、制表是我们在写作当中常用的一个功能。我们先看一个例子,看看在Markdown里用几行代码插入表格的效果是怎么样的:
1 | | 一个普通标题 | 一个普通标题 | 一个普通标题 | |
效果如下:
一个普通标题 | 一个普通标题 | 一个普通标题 |
---|---|---|
短文本 | 中等文本 | 稍微长一点的文本 |
稍微长一点的文本 | 短文本 | 中等文本 |
稍微再加一点要求,例如:对齐
1 | | 左对齐标题 | 右对齐标题 | 居中对齐标题 | |
出来的表格样式则是这样:
左对齐标题 | 右对齐标题 | 居中对齐标题 |
---|---|---|
短文本 | 中等文本 | 稍微长一点的文本 |
稍微长一点的文本 | 短文本 | 中等文本 |
从上面的例子我们可以看到:
- 默认情况下,标题栏居中对齐,内容居左对齐;
|
、-
、:
这些符号之间,多余的空格会被忽略,布局由Markdown部署;-:
表示内容和标题栏居右对齐;:-
表示内容和标题栏居左对齐;:-:
我们都猜到了,居中;|
分隔单元格,-
分隔表头和内容。
表格内支持插入其他Markdown行内标记,例如加粗、斜体、链接等等。
Markdown插入视听文件
事实上Markdown并不支持插入音频、视频,但是,Markdown支持html语法,我们可以通过html语句插入视听文件。用到的html标签是iframe
,代码解释如下:
- div用于控制格式,若无则默认为居左;
- frameborder用于规定是否显示框架周围的边框,1为是,0为否;
- marginwidth及marginheight表示距离边缘的像素大小;
- width及height表示播放条的长度和宽度;
- src为播放链接,可以在如网易云音乐的生成外链播放器获取该链接,同时也获得以下代码,并可以自行更改;
- 也可将音频链接改为视频链接,从而播放视频。
注意1:
音频和视频在默认情况下是会自动循环播放的,可以修改链接的值进行修改;
在src域中,auto值表示是否自动播放,当值为1时为自动播放,0则不是;
在src域中,有些链接会附有height或width值,其表示表示播放框的基本宽高,可以更换其值以获得想要的播放框大小,此时可以不用填写外部的width及height。
注意2:
有的Markdown解析不支持直接在markdown中直接贴iframe
语句。我们的解决办法是,在_includes
里建一个单独的html
文件。
例子
我们用一个例子来说明一下:
- 先在_includes文件夹中新建文件rxsweetTube。html,里面放入rxsweetTube给的
embed
语句。ID部分用``代替;
1 | {% raw %} |
- 在你撰写的markdown文件,需要插入视频的地方,插入语句:
1 | {% raw %} |
效果是这样的:
如果贴的是音频,道理一样,获取外链,同样操作即可。以网易云为例:
1 | {% raw %} |
上述是网易云生成的外链,不过要把width
和height
的值,用引号包起来,才能被kramdown解析。