Markdown 入门
Markdown是一种轻量级的标记语言,允许人们使用易读易写的纯文本格式编写文档,然后转换成结构化的HTML(超文本标记语言)文档。
以下是Markdown的一些基本语法:
1. 标题
在文字前面使用#
来表示标题级别。一个#
是一级标题,两个##
是二级标题,以此类推,最多支持六级标题。
# 一级标题
## 二级标题
### 三级标题
请用一个空格在 # 和标题之间进行分隔。
2. 段落与换行
要创建段落,请使用空白行多行文本进行分隔。
要创建换行,在一行的末尾添加两个或多个空格,即可创建一个换行(
)。
3. 加粗
要加粗文本,请在单词或短语的两端各添加两个星号(**
)或下划线(__
)。
**加粗的文字**
__同样加粗的文字__
用的更多的是两个星号。
4. 列表
- 无序列表可以使用星号、加号或是减号作为列表标记。最好有一个空格和具体内容分开。
* 元素一
+ 元素二
- 元素三
- 有序列表则使用数字接着一个英文句点。
``` 1. 第一点 2. 第二点 3. 第三点
```
5. 链接与图片
- 链接:使用 链接文字 的形式。
- 图片:使用
的形式。
如果是一个本地路径的文件,
6. 代码块
对于多行代码或较长的代码段落,应该使用三个反引号 ``` 来创建一个代码块。 此外,还可以指定语言类型以启用语法高亮(如果渲染器支持的话)。在反引号之后紧跟着语言标识符。
需确保在第一个前面和最后一个三重反引号后面没有额外的空格,否则可能会导致解析错误或不正确的渲染。
第一个三重反引号为行内顶格,不要有空格。
常见的语言标识符包括 python, javascript, html, css, java, c, cpp 等等。
7. 水平分割线
可以在单独一行中使用三个以上的星号***
、减号---
或下划线___
来创建一条水平线。
---
建议在分隔线的前后均添加空白行。