前往小程序,Get更优阅读体验!
立即前往
首页
学习
活动
专区
工具
TVP
发布
社区首页 >专栏 >文字编码 - Markdown 简明教程

文字编码 - Markdown 简明教程

作者头像
为为为什么
发布2022-08-04 12:16:08
4.2K0
发布2022-08-04 12:16:08
举报
文章被收录于专栏:又见苍岚

Markdown 是一种轻量级标记语言,文件以.md/.markdown为后缀,语法简单实用,编写的文档可以导出 HTML 、Word、图像、PDF、Epub 等多种格式,近年来快速流行在程序员群体中。本教程列举了markdown最常用的语法,仅需随便一款markdown编辑器即可轻松学习。

标题

文章题目,设有6个等级,可被获取生成文章目录。

语法:若干个(1-6)#后接空格代表不同级别(1-6)的标题

示例编码:

代码语言:javascript
复制
# 一级标题
## 二级标题
### 三级标题
#### 四级标题
##### 五级标题
###### 六级标题

实际效果:

分割线

方便分割内容

语法:***---则会出现一条线

示例编码:

代码语言:javascript
复制
---
***

实际效果:



格式标记

简单方便的格式标记

语法:* 内容*_内容_标记为倾斜; ** 内容**__内容__标记为加粗;*** 内容**___内容___标记为加粗倾斜。

示例编码:

代码语言:javascript
复制
*倾斜*
_倾斜_
**加粗**
__加粗__
***加粗倾斜***
___加粗倾斜___

实际效果:

列表

内容条理化的利器,分为有序列表和无序列表

有序列表

语法:序号加上.空格

示例编码:

代码语言:javascript
复制
1. 内容1
2. 内容2
3. 内容3

实际效果:

无序列表

语法:*+或是- 空格 作为列表标记

示例编码:

代码语言:javascript
复制
*  内容1
*  内容2
*  内容3

+  内容4
+  内容5
+  内容6

-  内容7
- 内容8
- 内容9

实际效果:

列表嵌套

语法: 使用4个空格缩进即可进行列表嵌套

示例编码:

代码语言:javascript
复制
1. 有序内容1
    + 无序内容1
    + 无序内容2
2. 有序内容2
    + 无序内容1
    + 无序内容2

实际效果:

区块(引用)

为内容分区块,可嵌套

语法:>空格 作为标记

示例编码:

代码语言:javascript
复制
> 第一层
>> 第二层
>>> 第三层
>>>> 第四层

实际效果:

代码

代码段可以用多种语言高亮显示代码,内容不会被markdown标记解释,有两种标记方式

代码片段

语法:用前后两个`` ` (主键盘区左上角,Esc下面的按键)包裹代码片段

示例编码:

代码语言:javascript
复制
`cout<<"Hello world"<<endl; `

实际效果:

代码区块

语法:建议用前后各三个`` `包裹代码作为markdown中的代码段,这种语法更容易被编辑工具识别和支持

示例编码:

代码语言:javascript
复制
``` c++
#include <iostream>
using namespace std;

int main()
{
   cout << "Hello World";
   return 0;
}
​```


实际效果:

{% asset_img daimaduan.png 代码区块示例 %}



## 链接

> 编辑文本变成超链接

语法:

`[` `链接名称` `]` `(` `链接地址` `)`       或       `<` `链接地址` `>` (中间无空格)

示例编码:

​```markdown
[又见苍岚](https://www.zywvvd.com)
或
 <https://www.zywvvd.com>

实际效果:

又见苍岚https://www.zywvvd.com

图片

语法格式:

代码语言:javascript
复制
![alt 属性](图片地址)
![alt 属性](图片地址 "可选标题")

示例编码:

代码语言:javascript
复制
![苍岚1](https://www.zywvvd.com/about/index/1.png)
![苍岚2](https://www.zywvvd.com/about/index/1.png "CangLan")

实际效果:

苍岚1
苍岚1
苍岚2
苍岚2

表格

可以方便地插入表格。

语法:用 | 分隔单元格,使用 - 来分隔表头和其他行, :- -: :-:分别表示左、右、中的对齐方式。

示例编码:

代码语言:javascript
复制

| 左对齐表头 | 右对齐表头|居中对齐表头|
|:--- | ---: |:---: |
|内容1| 内容2|内容3|
|内容4|内容5|内容6|

实际效果:

数学公式

可以插入Tex或LaTex等公式编辑器生成的格式代码

语法:输入$$包裹公式

示例编码:

代码语言:javascript
复制
$$
\mathbf{X}_1\times\mathbf{X}_2 = \mathbf{X}_3
$$

实际效果:

\mathbf{X}_1\times\mathbf{X}_2 = \mathbf{X}_3

而且公式可以编号和引用:

语法:

  • 编号:\tag{1}
  • 标签:\label{eq1}
  • 引用:\eqref{eq1}​

示例编码:

代码语言:javascript
复制
$$
\mathbf{X}_1\times\mathbf{X}_2 = \mathbf{X}_3 \tag{1} \label{eq1}
$$
在公式$\eqref{eq1}$中...

在公式

实际效果:

\mathbf{X}_1\times\mathbf{X}_2 = \mathbf{X}_3 \tag{1} \label{eq2}

在公式

任务列表

简单的任务标记

语法:- 空格[空格]空格不勾选 -空格[x]空格勾选

示例编码:

代码语言:javascript
复制
- [ ] 挣他一个亿
- [x] 花个五千万
- [ ]  存个五千万
- [ ] 年利息二百万
- [ ] 实现财务自由

实际效果:

脚注

支持脚注功能,鼠标悬停可以读出内容

语法: 文中定义脚注A - [^A](脚注前需要有内容),对应A的脚注文本[^A]: 脚注的*文本*

示例编码:

代码语言:javascript
复制
你可以使用脚注像这样[^脚注]
脚注前面需要有内容!!!
[^脚注]: 这里写脚注的*文本*

实际效果:

你可以使用脚注像这样[1] 脚注前面需要有内容!!!

高级链接

可以将链接地址放在变量中

语法: 链接[链接名称] [变量A],设置变量A [A]:链接地址

示例编码:

代码语言:javascript
复制
加油 [又见苍岚][a]

[a]:https://www.zywvvd.com

实际效果:

加油 又见苍岚

流程图

markdown支持流程图功能,这里介绍框架语法,只不过不是所有markdown编辑器、显示框架都支持

语法: ```mermaid 和 ``` 包裹的部分 可以解读成流程图

示例编码:

代码语言:javascript
复制
` ` `mermaid
graph LR
A[方形] -->B(圆角)
    B --> C{条件a}
    C -->|a=1| D[结果1]
    C -->|a=2| E[结果2]
    F[横向流程图]
` ` `

实际效果:

转义字符

Markdown 使用了很多特殊符号来表示特定的意义,如果需要显示特定的符号则需要使用转义字符,Markdown 使用反斜杠转义特殊字符

语法:\ 加特殊字符

示例编码:

代码语言:javascript
复制
**不想被加粗**

实际效果:

不想被加粗

目录

markdown可以根据标题内容自动提取目录

语法:[toc]回车即可

示例编码:

代码语言:javascript
复制
[toc]

实际效果:

使用HTML代码实现高级效果

markdown语法简单,内容表现丰富程度有限。但其本身兼容HTML代码,可以借助其实现高级显示的效果。

文本对齐

借助align属性可以实现文本对齐

示例代码:

代码语言:javascript
复制
<p align='center'>居中文本</p>
<p align='right'>右对齐文本</p>
<p align='left'>左对齐文本</p>

实际效果:

居中文本

右对齐文本

左对齐文本

图像水平排列

markdown自带图像插入功能无法水平自由排列,借助html中的table和img标签可以实现。

示例代码:

代码语言:javascript
复制
<table>
    <tr>
        <td ><center><img src="timg.jpg"  height="240" width="240"> </center></td>
    	<td ><center><img src="timg.jpg"  height="240" width="240"> </center></td>
    </tr>
    <tr>
        <td ><center> 图1  </center></td>
    	<td ><center> 图2 </center></td>
    </tr>
      <tr>
        <td ><center><img src="timg.jpg"  height="240" width="240"> </center></td>
    	<td ><center><img src="timg.jpg"  height="240" width="240"> </center></td>
    </tr>
    <tr>
        <td ><center> 图3  </center></td>
    	<td ><center> 图4</center></td>
    </tr>
</table>

实际效果:

图1

图2

图3

图4

合并单元格

markdown 自带语法只支持基本表格,复杂表格需要HTML语言描述。

示例代码:

代码语言:javascript
复制
<table>
	<tr>
	    <th colspan="2" rowspan="2" ><center>评估指标</center></th>
         <th colspan="2" ><center>预测结果</center></th>
    </tr>  
    <tr>
        <th  ><center>正样本</center></th>
        <th  ><center>负样本</center></th>
	</tr >
	<tr >
        <td rowspan="2"><center>实际<br>情况</center></td>
        <td><center>正样本</center></td>
        <td><center>TP</center></td>
        <td><center>FN</center></td>
	</tr>
    <tr >
        <td><center>负样本</center></td>
        <td><center>FP</center></td>
        <td><center>TN</center></td>
	</tr>
</table>

实际效果:

评估指标

预测结果

正样本

负样本

实际情况

正样本

TP

FN

负样本

FP

TN

文字改变颜色、大小、字体

示例代码:

代码语言:javascript
复制
<font face="宋体" >我是宋体字</font>

<font  size=10>我是10号字</font>

<font color=red>我是红色字</font>

<font color=red size=10 face='宋体'>我是红色10号宋体字</font>

实际效果:


  1. 这里写脚注的文本 ↩︎
本文参与 腾讯云自媒体同步曝光计划,分享自作者个人站点/博客。
原始发表:2020年2月18日,如有侵权请联系 cloudcommunity@tencent.com 删除

本文分享自 作者个人站点/博客 前往查看

如有侵权,请联系 cloudcommunity@tencent.com 删除。

本文参与 腾讯云自媒体同步曝光计划  ,欢迎热爱写作的你一起参与!

评论
登录后参与评论
0 条评论
热度
最新
推荐阅读
目录
  • 标题
  • 分割线
  • 格式标记
  • 列表
    • 有序列表
      • 无序列表
        • 列表嵌套
        • 区块(引用)
        • 代码
          • 代码片段
            • 代码区块
            • 图片
            • 表格
            • 数学公式
            • 任务列表
            • 脚注
            • 高级链接
            • 流程图
            • 转义字符
            • 目录
            • 使用HTML代码实现高级效果
              • 文本对齐
                • 图像水平排列
                  • 合并单元格
                    • 文字改变颜色、大小、字体
                    领券
                    问题归档专栏文章快讯文章归档关键词归档开发者手册归档开发者手册 Section 归档