How to use Markdown correctly.
这是我的第一篇Blog,为了熟练掌握博客的写法,我打算以“如何正确使用Md格式为”为本首篇博客的主题。 我使用的编辑器是VS Code ,插件使用的是 Markdown Preview Enhanced 。 更多详细的使用方法请参考官方文档
1 基本语法
1.1 字体设置斜体、粗体、删除线
| 操作 | 效果 |
|---|---|
| 正常文字 | 正常文字 |
| *这里是倾斜文字* | 这里是倾斜文字 |
| _这里是倾斜文字_ | 这里是倾斜文字 |
| **这里是加粗文字** | 这里是加粗文字 |
| ***这里是倾斜加粗文字*** | 这里是倾斜加粗文字 |
| ~~这里是删除线文字~~ |
1.2 分级标题
写法一
几级标题标题前就有几个#号
写法二
这是一个一级标题 = 标题下面写个“==”就有
这是一个二级标题
同理,--
1.3 链接
(1)插入本地图片
格式:


这里的“图片描述”不是必要的
例子:


注意:对于编辑器上的插件来讲,/_site/pics/pics1/Elon.png的路径,才能正确显示出图片;而对于jekyll构建的效果来讲,得拿/pics/pics1/Elon.png作为路径。
(2)插入互联网上的图片
格式:

注意:这里的图片描述可以不写
(3)自动链接
Markdown支持以比较简短的自动链接形式来处理网址和电子邮箱,只要是用<>包起来,Markdown就会自动把它转成链接,也可以是直接显示成链接形式。
1.4 分割线
你可以在一行中用三个以上的星号(*)、减号(-)、底线(_)来建立一个分隔线,行内不能有其他东西。你也可以在这些符号中间插入空格。 三种输入方式创造出来的分割线一样的,或许作者只是想让我们在写代码的时候区分开来。
效果如下:
1.5 代码块
(1)利用缩进(与前后文空一行)
#include<studio>
int main(){
printf("hello world")
}
(2)行内式 如果需要在一行内引用代码,只需要用反引号``引起来就好(在Esc下面,和~同一个键位)
这是一个例子
(3)多行代码块与语法高亮 在需要高亮的代码块的前一行及后一行使用三个单反引号“ ` ”包裹,就可以了
```javascript {highlight=10}
class demo(){
public static void test(){
}
}
```
(4)代码块里面包含html代码 在代码块里面,&、< 和 > 会自动转成HTML实体,这样的方式让你非常容易使用Markdown插入范例用的HTML原始嘛,只需要复制贴上,剩下的Markdown都会帮你处理。
示例如下:
<table>
<tr>
<th rowspan="2">值班人员</th>
<th>星期一</th>
<th>星期二</th>
<th>星期三</th>
</tr>
<tr>
<td>李强</td>
<td>张明</td>
<td>王平</td>
</tr>
</table>
结果显示:
<table>
<tr>
<th rowspan="2">值班人员</th>
<th>星期一</th>
<th>星期二</th>
<th>星期三</th>
</tr>
<tr>
<td>李强</td>
<td>张明</td>
<td>王平</td>
</tr>
</table>
1.6 引用
在引用的文本之前加上>符号,以及一个空格就行了; 如果只输入了一个>符号就会产生一个空白的引用。
(1)基本使用
张鑫阳有点小帅说是 真的嘛?
真的说是
(2)引用的嵌套
引用一
引用二
引用三
引用四
(3)引用其他要素 引用的区块内也可以使用其他的Markdown语法,包括标题、列表、代码区块等等内容。
你好啊
我很好
1.7 列表
(1)无序列表 使用*,+,- 表示无序列表
注意符号后面一定要有一个空格起到缩进的作用
- 列表文字
- 列表文字
- 列表文字
(2)有序列表 使用数字和一个英文句点表示有序列表
注意英文句点后面一定要有一个空格,起到缩进作用。
- 张鑫阳
- 陈卓
(3)有序列表、无序列表可以混用
(4)列表可以与其他元素混合使用
(1)加粗效果不能直接用于列表标题中,但是可以嵌套在列表里面混合使用 (2)列表中包含代码块(前面加2个tab或者8个空格,并且需要空一行,否则不显示)
- (1)的说明:* **(1)的说明**
(5)注意事项 再使用列表的时候,只要是数字后面加上英文的点,就会无意间产生列表
1.8 表格
格式: 学号|姓名|分数
-
小明 男 75 小红 女 79 小陆 男 92
效果: 学号|姓名|分数
-
小明 男 75 小红 女 79 小陆 男 92
2 常用技巧
2.1 换行
方法 1 :连续两个以上的空格+回车
方法 2 ;使用html语言换行标签
2.2 缩进字符
不断行的空白格 或 半角的空格 或 全角的空格
\ 你好你好 \&\nbsp;你好你好
\ 你好你好 \&\ensp;你好你好
\ 你好你好 \&\emsp;你好你好
你好你好(未缩进)
你好你好 你好你好
你好你好 你好你好
你好你好 你好你好
你好你好(未缩进)
字符1 字符2
2.3 特殊符号
(1)对于Markdown中的语法符号,前面加反斜线\即可显示符号本身
(2)对于一些特殊字符,示例如下:
❤ ❤
✓ ✓
☀ ☀
★ ★
☂ ☂
☯ ☯
☢ ☢
☎ ☎
∞ ∞
❄ ❄
♫ ♫
如果想了解更多字符所对应的Unicode码,可以看这个网站:http://unicode-table.com/cn/
2.4 字体、字号和颜色
Markdown是一种可以使用普通文本编辑器编写的标记语言,通过类似HTML的标记语法,它可以使普通文本内容具有一定的格式。但是它本身是不支持修改字体、字号与颜色等功能的!
<font face=”黑体”>我是黑体字</font>
我是黑体字<font color=#0099ff size=7 face=”黑体”>我是黑体字</font> <font color=#0099ff size=7 face=”黑体”>我是黑体字</font>
<font color=gray size=7 face=”黑体”>也可以使用已知颜色的名字</font>
也可以使用已知颜色的名字2.5 链接的高级操作
2.5.1 行内式
2.5.2 参考式链接
在文档插入图片的地方写![图片或者网址链接][标记],在文档最后写上[标记]:图片地址”标题”(最后这个标题可以不写)
2.5.3 内容目录
在段落中填写[TOC]以显示全文内容的目录结构,样式如开头。
2.5.4 锚点
锚点就是页内超链接。 比如我这里写下一个锚点,点击回到目录,就能跳转到目录。在目录中点击这一节,就能跳过来。
2.5.5 注脚
一般需要在添加注脚的文字后加上脚注名字[^注脚名字],称为加注。 然后在文本的任意位置(一般在最后)添加脚注,脚注前必须有对应的脚注名字。
示例如下: 使用Markdown1可以效率的书写文档,直接转换成HTML2。
脚注被自动搬运到最后面,请到文章的末尾查看,并且脚注后方的链接可以直接跳转回加注的地方。
2.6 背景色
Markdown本身不支持背景色设置,需要采用内置html的方式实现:借助 table, tr, td 等表格标签的 bgcolor 属性来实现背景色的功能。举例如下:
| 背景色是:orange |
2.7 emoji表情符号
emoji表情使用:EMOJICODE:的格式,详细列表可见
https://www.webpagefx.com/tools/emoji-cheat-sheet/
3 高端用法
3.1 Latex公式
使用Latex数学公式
-
行内公式:使用两个”$”符号引用公式 :$$ y =ax+b $
-
行间公式:使用两个”$$”符号引用公式
具体可以参考 markdown编辑器使用LaTex数学公式
latex数学符号详见:常用数学符号的 LaTeX 表示方法
3.2 流程图
st=>start:开始
op1=>operation:My Operation
c=>condition:Yes or No
e=>end:结束