十分钟快速上手 markdown

前言

本人利用寒假期间,将自己所学的markdown的知识,以及将自己常用的一些操作和注意事项记录下来,希望能够帮助大家

一、markdown是什么

Markdown 是一种轻量级标记语言,说白了就是可以让你利用最简单的语法达到最好的排版效果

二、如何使用markdown

首先基本上大部分的IDE内都自带markdown的功能,例如:pycharm、VScode等,使用的时候直接创建 .md 文件,在文件内进行即可。

注意:每个IDE使用markdown部分语法存在差异,个人建议还是使用专业的markdown编辑工具( Typora、Bear 等)

三、基本语法

3.1 标题

使用 # 标记,最后一个#字符与标题中间留一个空格。

angular2html 复制代码
# 标题一
## 标题二
### 标题三
#### 标题四
##### 标题五
###### 标题六

效果如下:


标题一

标题二

标题三

标题四
标题五
标题六

3.2 字体

使用 *\ 对字体进行设置

angular2html 复制代码
*这是一个斜体*  
_这也是斜体_  
**这是粗体**  
__这也是粗体__  
***这是一个粗斜体***  
___这也是粗斜体___  

效果如下:


这是一个斜体
这也是斜体
这是粗体
这也是粗体
这是一个粗斜体
这也是粗斜体


快捷键:

加粗Ctrl+B

斜体Ctrl+I

3.3 换行

下面是常用的换行方式

  • 直接在一句话后敲两个空格
  • 两句话之间加一个空行
  • 如果想让一行文字在显示的时候换行,就在中间加< br / >

3.4 引用

使用 > 来实现,还可以进行嵌套使用,具体使用看代码

angular2html 复制代码
> 这是一个引用
>> 引用的引用
>>> 引用的引用的引用

效果如下:


这是一个引用

引用的引用

引用的引用的引用


注意:在引用的区块内,允许换行存在,换行并不会终止引用的区块。如果要结束引用,需要一行空白行,来结束引用的区块。

3.5 链接

方式如下:

angular2html 复制代码
[链接名称](链接地址)或<链接地址>
即:
[百度](https:www.baidu.com)
或者
<https:www.baidu.com>

效果如下:


百度

或者
https:www.baidu.com


3.6 图片

方式如下:

angular2html 复制代码
![图片描述,可写可不写,但是中括号要有](图片地址,本地链接或者URL地址。)
示例如下:
![一个AI生成的动漫人物]("https://i-blog.csdnimg.cn/direct/7f92ae8988714197a4856a8e869ef4c9.jpeg")

效果如下:



3.7 列表

列表分为有序列表和无序列表

  • 无序列表,使用 *、+、- ,再加一个空格作为列表的标记
  • 有序列表,使用数字并加上.号,再加一个空格作为列表的标记
  • 如果想要控制列表的层级,则需要在列表符号前使用 Tab
angular2html 复制代码
* 无序列表 1
* 无序列表 2
* 无序列表 3

1. 有序列表 1
2. 有序列表 2
3. 有序列表 3

* 无序列表 第一层
    * 无序列表 第二层
        * 无序列表 第三层
            * 无序列表 第四层

1. 有序列表 第一层
    1.1 有序列表 第二层

效果如下:


  • 无序列表 1
  • 无序列表 2
  • 无序列表 3
  1. 有序列表 1
  2. 有序列表 2
  3. 有序列表 3

  • 无序列表 第一层
    • 无序列表 第二层
      • 无序列表 第三层
        • 无序列表 第四层
  1. 有序列表 第一层
    1.1 有序列表 第二层

3.8 分割线、删除线、下划线

  • 分割线:一行中用三个-or*来建立一个分割线,但是注意:在分割线的上面空一行,否则会导致前一行字体放大。
  • 删除线:添加删除线的文字前后添加两个~
  • 下划线:下划线的使用和html中类似,在需要添加下划线的文字首尾添加++文本++

代码如下:

angular2html 复制代码
分割线:

---
***
- - -
* * *

~~删除线~~

<u>下划线</u>

效果如下:


分割线:





删除线

++下划线++


3.9 代码块

只需要用反引号`引起来

如果是需要引用代码的话,则在需要引用的代码块的前一行和后一行使用三个反引号,同时在前一个反引号后写入代码的语言。

代码:

angular2html 复制代码
`Hello` World.

效果如下:


Hello World.


cpp 复制代码
#include<iostream>
int main(){
   printf("HelloWorld");
}

3.10 表格

表格使用|来分割不同的单元格,使用-来分隔表头和其他行

  • :---- : 将表头及单元格内容左对齐
  • ----: : 将表头及单元格内容右对齐
  • :---: : 将表头及单元格内容居中

代码:

angular2html 复制代码
| 项目       |     价格 | 数量 | 其他 |
|:---------|-------:|:--:|----|
| C语言速成    | \$2000 | 66 | 无  |
| python速成 | \$1200 | 78 | 无  |
| java速成   | \$1000 | 42 | 无  |

效果如下:

项目 价格 数量 其他
C语言速成 $2000 66
python速成 $1200 78
java速成 $1000 42

3.11 特殊符号

前面加反斜线 \ 即可以显示符号本身。

代码如下:

angular2html 复制代码
\\  
\*  
\_  
\+  
\.  
等等

效果如下:

\

*

_

.

等等

3.12 脚注

代码如下:

angular2html 复制代码
使用 Markdown[^1]可以效率的书写文档, 直接转换成 HTML[^2], 你可以使用 Typora[^T] 编辑器进行书写。
[^1]:Markdown是一种纯文本标记语言
[^2]:HyperText Markup Language 超文本标记语言
[^T]:NEW WAY TO READ & WRITE MARKDOWN.

效果如下:

使用 Markdown[1](#1)可以效率的书写文档, 直接转换成 HTML[2](#2), 你可以使用 Typora[3](#3) 编辑器进行书写。

  • 注意:脚注自动被搬运到最后面,请到文章末尾查看,并且脚注后方的链接可以直接跳转回到加注的地方。

四、总结

首先,本篇文章借鉴小刘在路上的一篇文章手把手教会你使用Markdown【从入门到精通一篇就够了】菜鸟教程等。

通过学习,自己总结所学的知识,并利用CSDN自带的MD编辑器,写出一篇属于自己的文章,后期无论是自己查找资料,或者复习,都比较方便,大家一起加油,一起进步!!!

还有其他的的高阶用法,但是个人感觉没必要,感兴趣的朋友可以看我上面借鉴的博主和文章哦


  1. Markdown是一种纯文本标记语言 ↩︎

  2. HyperText Markup Language 超文本标记语言 ↩︎

  3. NEW WAY TO READ & WRITE MARKDOWN. ↩︎

相关推荐
secondyoung4 天前
Markdown转换为Word:Pandoc模板使用指南
开发语言·经验分享·笔记·c#·编辑器·word·markdown
Source.Liu5 天前
【mdBook】6 在持续集成中运行 mdbook
markdown
Source.Liu6 天前
【mdBook】5.5 mdBook 特色功能
markdown
Source.Liu8 天前
【mdBook】7.1 预处理器
markdown
Source.Liu9 天前
【mdBook】5.2.3 渲染器配置详解
markdown
Source.Liu11 天前
【mdBook】5.2 配置
markdown
Source.Liu11 天前
【mdBook】1 安装
笔记·rust·markdown
qq74223498411 天前
免费版Markdown 编辑器:Typora
大模型·编辑器·markdown
Georgewu12 天前
【鸿蒙开源技术共建】用@luvi/lv-markdown-in在HarmonyOS上打造高性能Markdown编辑体验
harmonyos·markdown
Source.Liu12 天前
mdBook 开源笔记
笔记·rust·markdown