markdown基本指令 | 青训营笔记

252 阅读3分钟

这是我参与「第四届青训营 」笔记创作活动的的第2天!

markdown基本指令


1.为什么来学markdown了

自从学习编程以来就常常看到md文档,但一直不知道是什么意思,直到参加青训营的笔记活动才下定决心学习markdown,发现确实是很不错的工具,因此写一篇简单操作汇总方便大家(还有我自己)时时查阅。

2. markdown介绍

“markdown是一种可以使用普通文本编辑器编写的轻量级标记语言,通过简单的标记语法,它可以使普通文本内容具有一定的格式,可以导出 PPT、LaTex、HTML、Word、PDF、Epub、JPG等多种格式的文档,文档后缀为 .md。”

markdown上手容易且可应用在公众号,博客,笔记乃至论文等多个实用领域,而且有对程序员来说至关重要的版本管理系统,github上生成的README.md就是markdown文档。

3.markdown指令

3.1标题

  • 一级标题用一个 # 号表示
  • 二级标题用两个 # 号表示
  • 共六级标题。
  • #后加空格

3.2字体

*这里是文字*\(斜体)
_这里是文字_\(斜体)
**这里是文字**\(加粗)
***这里是文字***\(加粗斜体)
~~这里是文字~~(删除线)

显示效果如下:

这里是文字
这里是文字
这里是文字
这里是文字
这里是文字

3.3链接

<https://juejin.cn/>
或者
[掘金官网](https://juejin.cn/)

显示效果如下:

juejin.cn/

掘金官网

3.4分割线

在一行中用三个以上的*、-或_来建立分隔线

如: ***,---,___

显示效果如下:



3.5图片

![图片描述](图片地址)

如:

![2ebd235bfcb0829563ebe5f1021f4baf9a685206.jpg@240w_240h_1c_1s.webp](https://p6-juejin.byteimg.com/tos-cn-i-k3u1fbpfcp/09638f16155f4ff2a7db4a029a7b0e6a~tplv-k3u1fbpfcp-watermark.image?)

显示效果如下:

2ebd235bfcb0829563ebe5f1021f4baf9a685206.jpg@240w_240h_1c_1s.webp

3.6代码

一行引用代码只需用一对反引号括起来即可,多行代码(代码块)需要用三个反引号括起来,且须在第一行反引号后面标明所用的语言。

markdown支持的语言有:

bash,c,clojure,cpp,cs,css, dart,dockerfile, diff, erlang, go,gradle,groovy, haskell, java,javascript,json,julia, kotlin, lisp,lua, makefile,markdown,matlab, objectivec, perl,php,python, r,ruby,rust, scala,shell,sql,swift, tex,typescript, verilog,vhdl, xml, yaml

3.7引入

在被引用的文本前加上>符号和空格即可

如:> 引入

另有嵌套引入

>>引入1
>引入2

显示效果如下:

引入

引入1 引入2

-引入的区块内也可以使用如标题,代码块之类的指令

3.8列表

3.8.1无序列表

*,+,- 后加空格表示无序列表。

* 无序列表
+ 无序列表
- 无序列表

显示效果如下:

  • 无序列表
  • 无序列表
  • 无序列表

3.8.2有序列表

使用数字加上一个‘.’表示有序列表。

1.第一个
2.第二个

显示效果如下:

  1. 第一个
  2. 第二个

-在使用有序列表时,只要是数字后面加上一个‘.’,就会被识别为有序列表指令,比如2022.8.21,这时候我们想表达的是日期,这时候就要在每个点前面加上\。如:2022\.8\.21

3.9表格

表格的指令接近表格本身的形状,冒号在左边表示左对齐,右边表示有对齐,两边都有表示居中。

1.png

4.markdown技巧

4.1换行

连续两个以上空格+回车或直接使用html语言换行标签

4.2特殊符号

和html类似,在特殊符号前面加反斜杠(转义符)‘\’即可显示,如\*,\\,\#

显示效果如:*,\,#

5.其余功能总结

markdown还有支持许多高级功能,我认为不是很常用,决定只是列举出来,等需要时再去查询 其余功能有:锚点,注脚,数理化公式,流程图,待办列表,序列图,emoji(许多网站不支持,github可以)

6. 参考文章

Markdown入门指南
# Markdown语法图文全面详解\

7.整体总结

markdown作为一个文本编辑器比word来的更加简单顺手,支持许多html标签,样式设置一目了然,可以让笔者把注意力安心放在内容上,这次对markdown的基本学习不失为一次不错的尝试,以后也会多多用markdown写东西,记笔记,希望这篇文章可以对大家有所帮助!