这是一篇关于讲解如何正确使用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高亮示例
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.链接
支持直接粘贴链接地址。链接语法和显示如下:
语法1:[链接名称](http://链接网址)
显示:链接名称
或语法2:<http://链接网址>
显示:http://链接网址
邮箱:
users@huaqiu.com-[users@huaqiu.com](mailto:users@huaqiu.com)
6. 图片
可通过上传按钮上传图片,也支持直接粘贴图片,也支持拖拽上传图片。图片语法和显示如下:
语法:![请添加链接描述](图片地址)
设置图片大小 语法:![请添加链接描述](图片地址?=200)
设置图片对齐方式 语法:![请添加链接描述居中](图片地址#pic_center)
、![请添加链接描述左对齐](图片地址#pic_left)
、![请添加链接描述右对齐](图片地址#pic_right)
7. 有序列表&有序列表
无序列表的使用,在符号“-”后加空格使用。如下:
如果要控制列表的层级,则需要在符号“-”前使用空格。如下:
有序列表的使用,在数字及符号“.”后加空格几个,如下:
- 列表项
- 列表项
- 列表内容
- 列表内容
- 子列表内容
- 子列表内容
- 子列表内容
8. 分割线
可以在一行中用三个以上的星号、减号、底线来建立一个分隔线,同时需要在分隔线的上面空一行。
例:
-------
*****
______
9. 符号转义
如果你的描述中需要用到 markdown 的符号,比如 # *
等,但又不想它被转义,这时候可以在这些符号前加反斜杠,如 # *
进行避免。
10. 其他说明
使用富文本编辑器
发布的内容只能富文本编辑器
编辑,不可切换Markdown编辑器;
使用Markdown编辑器
发布的内容只能Markdown编辑器
编辑,不可切换富文本编辑器编辑。