最简单的Markdown使用教程

目录

最简单的Markdown使用教程(一)

题记:

markdown是一种轻量化标记语言,有点类似于HTML,但是相比于HTML来说,markdown可简单多了。 markdown的常用语法标记很少很少,少到你只需几分钟就能看完。 为什么要选择markdown语言呢?

  • 作为一名程序员,阅读文档,写文档是必备技能之一。而markdown在业内几乎是必备技能。
  • markdown语法简单,学习成本很低。
  • markdown的标记语法,让写作者只需沉浸于码字中,不用排版啦
  • markdown是纯文本内容,兼容性很强,纯文本软件就跟txt差不多。
  • 轻松导出HTML文档

说了那么多优点,说说缺点吧:

  • 排版单一,无法对文字改格式,比如正文各个位置字体大小啊,颜色啊,。
  • 对图片太不友好了。

没法,优缺点摆在这里,诸位自己选择吧!

markdown工具

考虑到诸位大佬,选择的平台不同,主流的操作系统,无非是windows、linux和Mac os web端听说简书是可以使用markdown的,我也没有用过 对于工具的推荐,我只说说windows和Linux,至于Macos我没有用过,就不敢说了。 我使用的工具是VSCODE。 作为一名程序员,绝不会陌生吧。 我选择的插件是Docs Markdown

如果你没有使用过VSCODE,强烈建议你下载体验。 现在我主要的开发环境都在VSCODE中了,顺带写个markdown,简直完美。 安装请自行搜索哦

markdown语法

1. 标题怎么弄?

标题很简单的: # 一级标题 ## 二级标题 ### 三级标题 以此类推

2. 目录怎么弄?

嗯哼,还记不记得word中的目录是怎么生成,背后实际是基于标题吧。 在这里一样的,不过更简单。 [toc] 是的,你没看错,就是在你想加入目录的地方,写上面那条命令。 快去试试吧。

3. 列表怎么弄?

列表也很简单。 无序列表:

  • 列表1
  • 列表2
  • 列表3

无序列表也可以:

  • 列表1
  • 列表2
  • 列表3

有序列表:

  1. 列表1
  2. 列表2
  3. 列表3

来个展示吧: 列表.png

4. 图片怎么弄?

快点趁热打铁,看看图片怎么弄。

插入图片 语法:
![]()
感叹号必须有
[]这里面写的是这个图片的title
()里面是图片的位置
()里面是图片的位置,又可以分为本地图片和链接图片
本地图片就是你计算机里面的图片
链接图片就是图片对应的是一个url索引

举个例子,正如刚才展示列表的哪个图片,语法: ![列表的图片](/列表.png) 输入上面,就出现刚才那个图片啦。 注:

  • 本地图片,如果与正在写的这个markdown文档在同目录,就不必写跟目录,就像上面写,就行。
  • 若非在同目录,那就必须加入根目录,如: F:/myBook/StudyWithoutStress/markdown使用教程/列表.png 当然你不怕长,在同目录下,你也可以加上嘛
  • 这里还有一个小问题,对于windows操作系统的使用者来说,在这里 文件搜索目录.PNG 复制得到的是:F:\myBook\StudyWithoutStress\markdown使用教程 看看和他的区别是什么啊? F:/myBook/StudyWithoutStress/markdown使用教程/列表.png 是的,你没看错,就是/\的区别,一定要用/,否则图片就挂了。 我在VSCODE测试时这样,别的工具我不敢保证哦!
  • 本地图片,只能我自己看,想让大家都看到,就要使用图床了 图床就是把自己本地的图片上传到服务器中,生成得到一个URL链接 我用过免费的如:SM.MS、GitHub。但是,他们的服务器都在国外,因为不可抗拒的原因,图片老挂 现在还没找到合适的方法,逃~

5. 链接怎么弄?

有了图片的经验,我们快看看链接怎么弄?趁热打铁嘛!

用法:[]()
插入链接与插入图片的语法是不是很像,区别在就一个!号

例子: 点下,这是链接哦,猜猜是什么链接

markdown语法

6. 某几个字怎么强调?

想象一下,在一篇密密麻麻的段落中,如何突现每几个字呢? 比如,我们在word中可以采用对需要强调的话进行标红或者斜体。 在Markdown中也又类似的功能。

*这里是斜体*
_这里是斜体_

**这里是加粗**
__这里是加粗__

效果如下:

这里是斜体 这里是斜体

这里是加粗 这里是加粗 快去试试吧,超简单。

7. 要插代码怎么弄?

一篇文章没有代码,怎么行呢? Markdown中插入代码的方法也很简单,可以分为两种: 一行代码和一段代码 主要是使用反引号`

  • 一行代码:
    用法:
    `int a = 1;`
    看到每两个反引号,中间加的就是一行代码的用法
    

    效果如下: int a = 1;


  • 一段代码: ```
    swap(int *x, int *y){ int temp; temp = *x; *x = *y; *y = temp; ``` 效果如下:
    swap(int *x, int *y){
      int temp;
      temp = *x;
      *x = *y;
      *y = temp;
    }
    

8. 插入表格怎么弄?

插入表格算是最复杂的语法了。 直接给个案例吧。 大家如果要插入表格,直接照猫画虎,就好了。 重点是不要记,用的时候查一下,最后慢慢就记住喽。

表头|条目一|条目二
:---:|:---:|:---:
项目|项目一|项目二

效果如下: 表头|条目一|条目二 :—:|:—:|:—: 项目|项目一|项目二

9. 分割线怎么弄?

有时候为了排版漂亮,我会加入分割线。 直接给出案例:

***
或
---

效果如下: ***


注意看效果,是不是出现了两条横线,是的,那个就是分割线。 两个命令可以生成分割线,你可以自由选择用那个。

10. 转义怎么弄?

在介绍一个,凑够10个吧。 转义字符 有时候为了在一段文字种加入特殊的符号,而这个符号恰恰是Markdown语法的符号。 此时,我们就可以使用转义”",避免两者混淆。 如:

**文本加粗**
\*\*将正常显示星号\*\*

效果如下: 文本加粗 **将正常显示星号**

尾记

如果会了前面10种常用命令,基本上可以说已经掌握了Markdown。

实际上,Markdown还可以画流程图、甘特图、写数学公式等等。

不过这些都不太常用,我们的大脑也没必要储存,还是用的时候在去查吧。

文章未经同意,不得转载哦,违者必究。

请我喝咖啡

取消

感谢您的支持,我会继续努力的!

扫码支持
扫码支持
扫码打赏,您说多少就多少

打开支付宝或微信扫一扫,即可请我喝咖啡哦