【使用指南】Markdown编辑器常用语法功能

elecfans小能手

2022-5-13 19:40:48

6328

这是一篇关于讲解如何正确使用Markdown的排版示例，希望通过此指南帮助大家轻松上手，通过Markdown让自己的文章有更加出色、更清晰明了的排版。

什么是 Markdown

Markdown (MD) 是现在普遍使用的一种文档书写语言格式，只需用一些非常简单易记的符号，如（# * / > [] () ），就可以轻松写出一篇具有良好的排版和可读性的文章。

语法示例

1.基本语法

一些常规的语法格式。

1.1 标题

标题用#+空格表示，不同数量的#可以表示不同的标题。建议帖子或回帖中的顶级标题使用Heading3，不要使用1或2，因为1是系统站点级，2是帖子标题级。示例：

Heading 1

Heading 2

Heading 3

Heading 4

Heading 5

Heading 6

1.2 粗体和斜体粗体

粗体：在需要操作的文字前后各加两个“*”。示例：

这个是粗体

斜体：在需要斜体的文字前后各加一个“*”。示例：

这个是斜体

粗体加斜体：在需要操作的文字前后各加三个“*”。示例：

这个是粗体加斜体

1.3 删除线

在需要删除的文字前后各使用两个符合“~~”。示例：

~~要删除的文字~~

1.4 引用

符号“>”后面书写文字。示例：

这个是引用

1.5 空行

如需空行，则可+回车换行

2.代码高亮

2.1 普通

*emphasize*    **strong**
_emphasize_    __strong__
@a = 1

2.2 语法高亮支持

如果在 ``` 后面跟随语言名称，可以有语法高亮的效果，如:

2.2.1 html/xml 代码高亮示例

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <meta http-equiv="X-UA-Compatible" content="IE=edge">
    <meta name="viewport" content="width=device-width, initial-scale=1.0">
    <title>Document</title>
</head>
<body>  
</body>
</html>

2.2.2 Python高亮示例

#!/usr/bin/python3
# Fibonacci series: 斐波纳契数列
# 两个元素的总和确定了下一个数
a, b = 0, 1
while b < 10:
print(b)
a, b = b, a+b

2.2.3 CSS 文件示例

body {
    background-color: red;
}
h1 {
    color: orange;
    text-align: center;
}
p {
    font-family: "Times New Roman";
    font-size: 20px;
}

支持语言有: HTML/XML, JSON, Bash, CSS, Java, JavaScript, PHP, Python, Rust, C/C++ …

3.绘制表格

| Column 1 | Column 2 | Column 3 |

| -------- | -----: | :----: |

| cell 1 | cell 2 | cell 3 |

| cell 4 | cell 5 | cell 6 |

| cell 7 | cell 8 | cell 9 |

| Column 1 | Column 2 | Column 3 |

| -------- | -----: | :----: |

| cell 1 | cell 2 | cell 3 |

| cell 4 | cell 5 | cell 6 |

| cell 7 | cell 8 | cell 9 |

4.Todo列表

语法：

在电子发烧友-专栏发一篇技术文章

5分钟搞定俄罗斯方块---组件化实战

服务早期红利与各项技术场景创新分析

显示：

在电子发烧友-专栏发一篇技术文章
5分钟搞定俄罗斯方块---组件化实战
服务早期红利与各项技术场景创新分析

5.链接

支持直接粘贴链接地址。链接语法和显示如下：

语法1：[链接名称](http://链接网址)

显示：链接名称

或语法2：<http://链接网址>

显示：http://链接网址

邮箱：

users@huaqiu.com-[users@huaqiu.com](mailto:users@huaqiu.com)

6. 图片

可通过上传按钮上传图片，也支持直接粘贴图片，也支持拖拽上传图片。图片语法和显示如下：

语法：![请添加链接描述](图片地址)

设置图片大小语法：![请添加链接描述](图片地址?=200)

设置图片对齐方式语法：![请添加链接描述居中](图片地址#pic_center)、![请添加链接描述左对齐](图片地址#pic_left)、![请添加链接描述右对齐](图片地址#pic_right)

7. 有序列表&有序列表

无序列表的使用，在符号“-”后加空格使用。如下：

列表项
列表项
列表项

如果要控制列表的层级，则需要在符号“-”前使用空格。如下：

列表项
列表项
- 列表内容
- 列表内容

有序列表的使用，在数字及符号“.”后加空格几个，如下：

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

8. 分割线

可以在一行中用三个以上的星号、减号、底线来建立一个分隔线，同时需要在分隔线的上面空一行。

例：

-------

*****

______

9. 符号转义

如果你的描述中需要用到 markdown 的符号，比如 # * 等，但又不想它被转义，这时候可以在这些符号前加反斜杠，如 # *进行避免。

10. 其他说明

使用富文本编辑器发布的内容只能富文本编辑器编辑，不可切换Markdown编辑器；

使用Markdown编辑器发布的内容只能Markdown编辑器编辑，不可切换富文本编辑器编辑。

只看该作者 淘帖0 举报

3 条评论

只看该作者

笑过就走 2022-8-15 18:46:27

沙发

1赞回复

dven 2023-12-7 09:45:00

板凳

有个严重bug，大写扩展名的图片（.JPG等等）传不上去，苹果手机导出都是大写JPG

搜索历史