0%

经验技术 - 0.自用更新博客 - Mardown语法和软件

1.软件

1. MarkText - 个人使用

2.Notepad++ - 备用

2..Markdown排版,语法

个人推荐这个大佬的介绍 —– 左边代码,右边效果)

简单语法帮助

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
Quick Markdown    ---------    快速Markdown

# Header1 --------- 标题1
## Header2 --------- 标题2

**Bold** --------- 加粗
*Emphasize* --------- 斜线
++Underline++ --------- 下划线
~~Strikethrough~~ --------- 删除线
==Highlight== --------- 高亮
^Superscript^ --------- 上标
-Subscript- --------- 下标

![alt text](url) --------- 替代文字,网址
[link text](url) --------- 连接文本,网址
@[alt text](url) --------- @替代文字,网址

- Unordered list --------- 无序列表
1. Order list --------- 数字列表
-[] Task list --------- 任务列表

[^id] ---------
[^id]:text ---------
`code` --------- 代码
```block code``` --------- 块代码
$$$inline math$$$ --------- 内联匹配
$$block match$$ --------- 块匹配
|--|table --------- 表
* * *page break --------- 分页符
- - -section break --------- 分节符
_ _ _sentence break --------- 句子中断

[TOC] --------- 返回标题

Markdown 折叠

其实这也是通过html语法实现的功能,你可以测试一下(拒绝IE,它不支持):

我有些话想跟你说

等等,让我想想是什么话。

哎呀,忘记了。

实现上述折叠效果的代码如下:

1
2
3
4
5
<details>
<summary>我有些话想跟你说</summary>
<p> 等等,让我想想是什么话。</p>
<p> 哎呀,忘记了。</p>
</details>

Markdown插入表格

终于是一个Markdown本身就支持的功能了。表格制表是我们在写作当中常用的一个功能。我们先看一个例子,看看在Markdown里用几行代码插入表格的效果是怎么样的:

1
2
3
4
| 一个普通标题 | 一个普通标题 | 一个普通标题 |
| ------| ------ | ------ |
| 短文本 | 中等文本 | 稍微长一点的文本 |
| 稍微长一点的文本 | 短文本 | 中等文本 |

效果如下:

一个普通标题 一个普通标题 一个普通标题
短文本 中等文本 稍微长一点的文本
稍微长一点的文本 短文本 中等文本

稍微再加一点要求,例如:对齐

1
2
3
4
| 左对齐标题 | 右对齐标题 | 居中对齐标题 |
| :------| ------: | :------: |
| 短文本 | 中等文本 | 稍微长一点的文本 |
| 稍微长一点的文本 | 短文本 | 中等文本 |

出来的表格样式则是这样:

左对齐标题 右对齐标题 居中对齐标题
短文本 中等文本 稍微长一点的文本
稍微长一点的文本 短文本 中等文本

从上面的例子我们可以看到:

  • 默认情况下,标题栏居中对齐内容居左对齐
  • |-:这些符号之间,多余的空格会被忽略,布局由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文件。

例子

我们用一个例子来说明一下:

  1. 先在_includes文件夹中新建文件rxsweetTube。html,里面放入rxsweetTube给的embed语句。ID部分用``代替;
1
2
3
{% raw %}
<iframe width="560" height="315" src="https://www.rxsweetTube.com/embed/{{ include.id }}" frameborder="0" allowfullscreen></iframe>
{% endraw %}
  1. 在你撰写的markdown文件,需要插入视频的地方,插入语句:
1
2
3
{% raw %}
{% include rxsweetTube.html id="IlkBLwl4aBM" %}
{% endraw %}

效果是这样的:

如果贴的是音频,道理一样,获取外链,同样操作即可。以网易云为例:

1
2
3
{% raw %}
<iframe frameborder="no" border="0" marginwidth="0" marginheight="0" width="330" height="86" src="//music.163.com/outchain/player?type=2&id={{ include.id }}&auto=0&height=66"></iframe>
{% endraw %}

上述是网易云生成的外链,不过要把widthheight的值,用引号包起来,才能被kramdown解析。