十分钟快速上手 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^可以效率的书写文档, 直接转换成 HTML^2^, 你可以使用 Typora^3^ 编辑器进行书写。

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

四、总结

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

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

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


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

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

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

相关推荐
BIT祝威13 天前
拥有自己的解析器(C#实现LALR(1)语法解析器和miniDFA词法分析器的生成器)
markdown·面向对象·编译器·compiler
杨浦老苏13 天前
无数据库开源Wiki引擎WikiDocs
docker·markdown·群晖·wiki
shao91851614 天前
大模型UI:Gradio全解11——Chatbot:融合大模型的聊天机器人(4)
markdown·gradio·chatbot·streaming·blocks
wuzuyu36515 天前
doc、pdf转markdown
pdf·markdown
君醉酒15 天前
pandoc + wkhtmltox 批量转换Markdown文件为PDF文件
python·pdf·markdown·pandoc·wkhtmltopdf
听吉米讲故事16 天前
MinerU:高效智能PDF文档解析工具完全指南
pdf·llm·markdown
桃园码工1 个月前
1-markdown转网页样式页面 --[制作网页模板] 【测试代码下载】
markdown·网页样式页面·制作网页模板
cheese-liang1 个月前
Markdown如何导出Html文件Markdown文件
markdown
cheese-liang1 个月前
Markdown表格的使用
markdown