Markdown 学习笔记 V2.0

原创
2020/03/09 20:02
阅读数 204

什么是Markdown?

Markdown是一门轻量级标记语言(ML),纯文本文件,因此可以使用任意文本编辑器编辑和使用。

Markdown 语言在 2004 由约翰·格鲁伯(John Gruber)创建。

Markdown 文档支持导出为 HTML 、Word文档、RTF、图像、PDF、Epub、LaTeX和文本 等多种格式文件。

Markdown 编写的文档后缀为 .md、.markdown。

Markdown支持嵌入部分HTML代码,例如下划线、表格和指定字体属性等。

为什么使用Markdown?

Markdown作为文本文件,编辑器多样化,文件导出格式多元化。天生具有跨平台特性,部分编辑器支持实时预览,轻松上手。

Markdown 常用编辑器有三类。

第一类是在线集成工具,例如OSChina和简书等,具有在线编辑、保存发布功能。

第二类是独立软件,例如Atom、Typora等,一般均为跨平台开发工具。

第三类为多功能代码编辑软件,例如Visual Studio Code、SublimeText、HBuilder X 和Atom 编辑器等,通过插件支持编辑和导出等操作。

Markdown标题(注意字体段落前显示段落显示效果)

Markdown标题分为两组,一组分别是大标题和小标题。大标题使用=表示,小标题使用-表示。

大标题

<font color=red>注意:连续3个-或*也表示分割线。</font>

小标题

另一组使用#表示1-6级标题(H1-H6),具体使用如下

# 一级标题
## 二级标题
### 三级标题
#### 四级标题
##### 五级标题
###### 六级标题

显示效果见大纲视图下表

一级标题

二级标题

三级标题

四级标题

五级标题

六级标题

字体

Markdown常见字体效果有加粗、斜体、加粗斜体和删除线等。* 和** 表示斜体和粗体。

下划线字体使用u标签。<u>下划线字符</u>

**加粗文字**
*斜体文字*`
***斜体加粗文字***
~~删除线文字~~

温馨提示:**`**字符位于键盘Esc和Tab中间位置。

字体属性可以直接手动设置。例如指定字体、字号和颜色等。

<font face="微软雅黑" >微软雅黑字体</font>
<font face="黑体" >黑体</font>
<font size=3 >3号字</font>
<font size=4 >4号字</font>
<font color=#FF0000 >红色</font>
<font color=#008000 >绿色</font>
<font size=4 face="仿宋" color="red">4号仿宋红色字体</font>

<font face="微软雅黑">微软雅黑字体</font>

<font face="黑体">黑体</font>

<font face="SIMYOU">幼圆字体</font>

<font size =3>3号字体</font>

<font size=5>5号字体</font>

<font color=#008000 >绿色字体</font>

<font size=4 face="仿宋" color="red">4号仿宋红色字体</font>

引用(区块)

引用使用>符号,可以多次嵌套使用。

>根引用
>>二级引用
>>>三级引用

根引用

二级引用

三级引用

超链接

使用 [描述](链接地址) 为文字增加外链接。
例如 [OSChina开源中国](https://www.oschina.net)

开源中国首页:OSChina开源中国

Markdown 支持使用文本强调标注。

列表

列表分为无序列表和有序列表,和HTML列表有些类似。*+-均可作为列表表示符号,符号后需要加上一个空格,未加空格显示异常。列表支持嵌套。

无序列表

- 列表内容
+ 列表内容
* 列表内容
*列表内容
  • 列表内容
  • 列表内容
  • 列表内容

有序列表

有序列表使用数字+.,同时使用空格分隔。

1. 列表内容
2. 列表内容
3. 列表内容
  1. 列表内容
  2. 列表内容
  3. 列表内容

嵌套列表

嵌套内容表示符号和一级列表内容需要<font color="red">保留3个以上空格</font>,同时不能省略*+-后空格。

  1. 一级列表内容

    • 一级列表嵌套内容
    • 一级列表嵌套内容
  2. 一级列表内容

    • 一级列表嵌套内容
  3. 一级列表内容

    • 一级列表嵌套内容 列表和
  • 第一项

  • 想·第二项

引用和表格可以嵌套。

> Markdown教程
   * 咸鱼有梦想

Markdown教程

  • 咸鱼有梦想

表格

Markdown支持简单表格,可以设置对齐方式。|分隔单元格, ---分隔列, :和---配合设置对齐格式。支持直接嵌入HTML表格代码。

name  | birthday
---   | ---
张三   | 1977-7-9
Tom   | 2018-1-1
name birthday
张三 1977-7-9
Tom 2018-1-1

表格两端推荐使用|并使用空格。

| name  | birthday | 住址 |
| ---   | --- | --- |
| 张三   | 1977-7-9 | 中国 |
| Tom   | 2018-1-1 | 美国 |
name birthday 住址
张三 1977-7-9 中国
Tom 2018-1-1 美国

表格对齐示例代码和效果。

| 表格标题 | Title | 表格 |
| :--- | :----: | ----: |
| 左对齐 | 居中对齐 | 右对齐 |
| left  | middle | right    |
表格标题 Title 表格
左对齐 居中对齐 右对齐
left middle right

Exceltk 支持将Excel文件转换为Markdown表格。ExceltkGithub项目地址

代码

`单行代码`
`System.out.println("Hello world.");`

Java代码演示单行代码块。

System.out.println("Hello world.");

C#代码演示多行代码块。

```
//交换变量练习
int x, y;
int temp;
x = 0;
y = 1;
Console.WriteLine(x.ToString(), y.ToString());
temp = x;
x = y;
y = temp;
Console.WriteLine(x.ToString(), y.ToString());
```

图片

Markdown支持本地和超链接图片。

需要指出本地图片可能会因为文件被移动、删除或改名等原因导致无法显示。互联网图片需要联网才能加载正常。

联网图片:百度首页图片

百度logo

使用本地图片建议将图片和Markdown文件放在相同文件夹,并为图片等多媒体创建文件夹,网络上部分教程推荐使用图片服务器加速,我推荐使用博客等加速。

本地图片演示。可以同时设置图片标题和缩放等。

温馨提示:图片地址修改后需要重新指定正确地址。

<img src="https://oscimg.oschina.net/oscnet/up-759ae20f14c8e3d074f8b05ded91b57d4ff.JPEG" alt="huaji" style="zoom: 33%;" />

转义符

页面中不可避免会出现 * 等特殊字符。需要使用转义字符。

需要转义字符主要有.、 +、-、*、!、`、\、_、和{}、()、和[]等。

数学公式

Markdown数学公式使用mathjax渲染。支持美元符号$ 包裹。

$$
E=mc^{2} 
$$

$$ E=mc^{2} $$

流程图

支持简单流程图绘制。流程图支持普通流程图、甘特图和时序图等,属于高级操作。

flow
st=>start: Start
op=>operation: operating conditions
cond=>condition: Yes or No?
e=>end
st->op->cond
cond(yes)->e
cond(no)->op
​```flow

脚注和参考文献

脚注、公式和参考文献等推荐学习基础LaTeX知识,同时安装好Pandoc并学习。

Happy Markdown!

展开阅读全文
打赏
0
0 收藏
分享
加载中
打赏
0 评论
0 收藏
0
分享
返回顶部
顶部