Markdown 学习笔记
本文由Markdown编写,效果如是:
学习网站: 菜鸟教程
编辑器:Typora
主题:非默认、下载的Purple主题
正文
目录
一. Markdown 简介
二. Markdown 标题
三. Markdown 段落格式
四. Markdown 列表
五. Markdown 区块
六. Markdown 代码
七. Markdown 链接
八. Markdown 图片
九. Markdown 表格
十. Markdown 高级技巧
小注:
- 可以通过按
Shift
+Enter
键在编辑视图中显式插入单个换行符。- 纯文本粘贴:
Ctrl
+Shift
+v
- 加粗标题:先标题,后加粗
[TOC]
:添加目录
一、Markdown 简介
- Markdown 是一种轻量级标记语言,它允许人们使用易读易写的纯文本格式编写文档。
- Markdown 语言在 2004 由约翰·格鲁伯(英语:John Gruber)创建。
- Markdown 编写的文档可以导出 HTML 、Word、图像、PDF、Epub 等多种格式的文档。
- Markdown 编写的文档后缀为 .md, .markdown。
1. Markdown 应用
- Markdown 能被使用来撰写电子书,如:Gitbook。
- 当前许多网站都广泛使用 Markdown 来撰写帮助文档或是用于论坛上发表消息。例如:GitHub、简书、reddit、Diaspora、Stack Exchange、OpenStreetMap 、SourceForge等。
2. 编辑器:Typora
3. 编辑器主题:Purple(不同主题,格式呈现效果不同,但是语法都一样)
二、Markdown 标题
使用 # 号可表示 1-6 级标题,一级标题对应一个 # 号,二级标题对应两个 # 号,以此类推。
写法如下:
# 一号小黄
## 二号小黄
### 三号小黄
Purple
主题效果如下:(主题不同,不同级别标题表现形式不同,如:默认的Whitey
主题标题均居中)
一号小黄
二号小黄
三号小黄
三. Markdown 段落格式
1. 段落换行:
两个空格
+回车键
注: 可以通过按Shift
+Enter
键在编辑视图中显式插入单个换行符。
2. 字体:
- 斜体:
*包裹
- 加粗:
**包裹
- 粗斜体:
***包裹
3. 分隔线:空行输入***
4. 删除线:用~~包裹起来
5. 下划线 :可以通过 HTML 的<u> 标签来实现</u>,包裹起来
6. 脚注:(感觉用不到,用的时候再说吧)
四. Markdown 列表
1. 分类:有序列表、无序列表
- 无序列表:
*+空格
(注:再内层需要——4个空格
+*
+空格
、后边会单独提到嵌套)
写法如下:
* 第一项
* 第一层
* 第二层
* 第三层
* 第二项
* 第三项
效果如下:
- 第一项
- 第一层
- 第二层
- 第三层
- 第二项
- 第三项
- 有序列表:
数字
+.
+空格
写法如下:
1. 第一
2. 第二
3. 第三
效果如下:
- 第一
- 第二
- 第三
2. 列表嵌套:4个空格
+*
+空格
写法如下:
1. 第一层:
* 第一层嵌套一
* 第一层嵌套二
效果如下:
- 第一:
- 第一层嵌套一
- 第一层嵌套二
五. Markdown 区块
1. 段落开头使用 >
+空格
写法如下:
> 小黄
> 小红
> 小蓝
效果如下:
小黄
小红
小蓝
2. 区块可嵌套 注:每层都要是>
+空格
写法如下:
> 内二层
> > 内一层
> >
> > > 最内层
效果如下:
内二层
内一层
最内层
3. 可以在:区块中使用列表、列表中使用区块
六. Markdown 代码
1. 段落内插入片段的代码:
写法如下:
`include <reg51.h>` 这是头文件
效果如下:
include <reg51.h>
这是头文件
2. 代码块
* 代码区块使用 4 个空格或者一个制表符(Tab 键)
* 也可以用 ```包裹一段代码,并指定一种语言(也可以不指定):
void uart_send1 (UART_MemMapPtr uartch, uint8 ch)
{
//等待发送缓冲区空
while(!(UART_S1_REG(uartch) & UART_S1_TDRE_MASK));
//发送数据
UART_D_REG(uartch) = (uint8)ch;
}
七. Markdown 链接
1. [链接名称](链接地址)
写法如下:
[百度网](www.baidu.com)
效果如下:
百度网
2. <链接地址>
写法如下:
<www.baidu.com>
效果如下:
<www.baidu.com>
3. 高级链接(用的时候再学吧)
八. Markdown 图片
语法:
![alt 属性文本](图片地址)
![alt 属性文本](图片地址 "可选标题")
注:
开头一个
感叹号 !
接着一个方括号
,里面放上图片的替代文字
接着一个普通括号
,里面放上图片的网址
,最后还可以用引号包住并加上选择性的 ‘title’ 属性的文字。
写法如下:
![百度](https://www.baidu.com/img/PCtm_d9c8750bed0b3c7d089fa7d55720d6cf.png)
效果如下:
九. Markdown 表格
1. 使用 | 来分隔不同的单元格,使用 - 来分隔表头和其他行。
写法如下:
| 姓名 | 分数 |
| ---- | ---- |
| 小黄 | 10分 |
| 小蓝 | 10分 |
效果如下:
姓名 | 分数 |
---|---|
小黄 | 10分 |
小蓝 | 10分 |
2. 对齐方式:
-: 设置内容和标题栏居右对齐。
:- 设置内容和标题栏居左对齐。
:-: 设置内容和标题栏居中对齐。
写法如下:
| 左对齐 | 右对齐 | 居中对齐 |
| :-----| ----: | :----: |
| 单元格 | 单元格 | 单元格 |
| 单元格 | 单元格 | 单元格 |
效果如下:
左对齐 | 右对齐 | 居中对齐 |
---|---|---|
单元格 | 单元格 | 单元格 |
单元格 | 单元格 | 单元格 |
十. Markdown 高级技巧(略)
- 支持的 HTML 元素
- 转义
- 公式
- 流程图、时序图、顺序图、甘特图…
式:
-: 设置内容和标题栏居右对齐。
:- 设置内容和标题栏居左对齐。
:-: 设置内容和标题栏居中对齐。
写法如下:
| 左对齐 | 右对齐 | 居中对齐 |
| :-----| ----: | :----: |
| 单元格 | 单元格 | 单元格 |
| 单元格 | 单元格 | 单元格 |
效果如下:
左对齐 | 右对齐 | 居中对齐 |
---|---|---|
单元格 | 单元格 | 单元格 |
单元格 | 单元格 | 单元格 |
十一. Markdown 高级技巧(略)
- 支持的 HTML 元素
- 转义
- 公式
- 流程图、时序图、顺序图、甘特图…