十分钟快速上手 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. ↩︎

相关推荐
大家的林语冰3 天前
连 Markdown 都不放过,Rust 在前端基建杀疯了,万物皆可“锈化“!
前端·javascript·markdown
曲幽8 天前
别只盯着GitBook了!这个文档神器让你的笔记秒变网站
web·markdown·docsify·seo·gitbook·vuepress·document·index
一只fish11 天前
一文了解Markdown
html·markdown
vortex512 天前
CheatMD:让 Markdown 笔记变成可执行的交互式命令
笔记·网络安全·markdown
MIXLLRED13 天前
随笔——在 Ubuntu 22.04 中查看 Markdown (.md) 文件
linux·运维·ubuntu·markdown
不剪发的Tony老师15 天前
MarKing:一款现代化专业级Markdown编辑器
文本编辑器·markdown·知识管理
Soari15 天前
GitHub 开源项目解析:microsoft/markitdown —— 面向 LLM 的多格式文档转 Markdown 工具
microsoft·开源·github·markdown·rag
仿生狮子18 天前
🎼 从文本到交互界面——GenUI 的中庸之道
前端·vue.js·markdown
X档案库20 天前
告别臃肿与残缺!MarkShareX——AI原生+Rust轻量自托管Markdown博客,一站式建站首选
ai·博客·markdown
小皮咖22 天前
推荐一个在线 Markdown 编辑器:Suporka MD
markdown