如何编辑 .md 文档 (基础)

如何编辑 .md 文档

Markdown 是一种轻量级标记语言,它允许人们使用易读易写的纯文本格式编写文档。

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

Markdown 编写的文档可以导出 HTML 、Word、图像、PDF、Epub 等多种格式的文档。

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

  工具:VSCode

一、标题

标题其实和HTML中的h系列很像,想要设置为标题的文字前面加#来表示 一个#是一级标题,二个#是二级标题,以此类推。支持六级标题。

注:标准语法一般在#后跟个空格再写文字 示例:

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

效果如下:

一级标题

二级标题

三级标题

四级标题

五级标题
六级标题

二、字体

加粗:要加粗的文字左右分别用两个 * 号包起来

斜体:要倾斜的文字左右分别用一个 * 号或者用 _ 包起来

斜体加粗:要倾斜和加粗的文字左右分别用三个*号包起来

删除线:要加删除线的文字左右分别用两个~~号包起来

示例:

**加粗**
*斜体*  _斜体_
***斜体加粗***
~~删除线~~

效果如下:

加粗 斜体 斜体 斜体加粗 删除线

三、引用

在引用的文字前加>即可。引用也可以嵌套,如加两个>>三个>>> n个...

示例: >这是引用的内容 >>这是引用的内容 >>>这是引用的内容 >>>>...

效果如下:

这是引用的内容

这是引用的内容

这是引用的内容

...

四、分割线

三个或者三个以上的 - 或者 * 都可以。

示例: --- ***

效果如下:



五、图片

语法:

![图片alt](图片地址 "图片title")

图片alt就是显示在图片下面的文字,相当于对图片内容的解释。 图片title是图片的标题,当鼠标移到图片上时显示的内容。title可加可不加

效果如下:

迪迦

六、超链接

语法:

[超链接名](超链接地址 "超链接title")
title可加可不加

示例: 百度

七、列表

无序列表

语法: 无序列表用 - + * 任何一种都可以

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

注意:- + * 跟内容之间都要有一个空格 效果如下:

  • 列表内容
  • 列表内容
  • 列表内容

有序列表

语法: 数字加点加空格

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

注意:序号跟内容之间要有空格

效果如下:

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

列表嵌套

列表嵌套只需在子列表中的选项前面添加四个空格即可:

- 无序列表
    1. 有序列表
    2. 有序列表
- 无序列表
    1. 有序列表
    2. 有序列表
        - 无序列表

效果如下:

  • 无序列表
    1. 有序列表
    2. 有序列表
  • 无序列表
    1. 有序列表
    2. 有序列表
      • 无序列表

八、表格

Markdown 制作表格使用 | 来分隔不同的单元格,使用 - 来分隔表头和其他行。

语法格式如下:

|  表头   | 表头  |
|  ----  | ----  |
| 单元格  | 单元格 |
| 单元格  | 单元格 |

第二行分割表头和内容。
- 有一个就行,为了对齐,多加了几个
文字默认居左
-两边加:表示文字居中
-右边加:表示文字居右

效果如下: | 表头 | 表头 | | ---- | ---- | | 单元格 | 单元格 | | 单元格 | 单元格 |

对齐方式:

| 左对齐 | 右对齐 | 居中对齐 |
| :-----| ----: | :----: |
| 单元格 | 单元格 | 单元格 |
| 单元格 | 单元格 | 单元格 |

我们可以设置表格的对齐方式:

-: 设置内容和标题栏居右对齐。
:- 设置内容和标题栏居左对齐。
:-: 设置内容和标题栏居中对齐。

效果如下: | 左对齐呵呵哈哈哈 | 右对齐哈哈哈 | 居中对齐呵呵哈哈哈 | | :-----| ------: | :----: | | 单元格 | 单元格 | 单元格 | | 单元格 | 单元格 | 单元格 |

九、代码

语法: 单行代码:代码两边用一个反引号括起来

`prinf()`

多行代码:用三个反引号括起来,在第一个```后可以标注语言类型

    ```sql
    -- 创建表
    CREATE TABLE emp (
    -- int类型
    emp_id INT,
    -- 最多保存20个中英文字符
    emp_name VARCHAR(20),
    -- 总位数不超过15位
    salary DOUBLE,
    -- 日期类型
    birthday DATE
    );
    ```

效果如下: prinf()

-- 创建表
CREATE TABLE emp (
-- int类型
emp_id INT,
-- 最多保存20个中英文字符
emp_name VARCHAR(20),
-- 总位数不超过15位
salary DOUBLE,
-- 日期类型
birthday DATE
);

其他

目录[TOC]

在想要显示目录的位置标注: [TOC]

首行缩进:  

 表示一个中文字符间隔

参考:菜鸟教程

评论

暂无评论