最简单的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
- 列表2
- 列表3
来个展示吧:
4. 图片怎么弄?
快点趁热打铁,看看图片怎么弄。
插入图片 语法:
![]()
感叹号必须有
[]这里面写的是这个图片的title
()里面是图片的位置
()里面是图片的位置,又可以分为本地图片和链接图片
本地图片就是你计算机里面的图片
链接图片就是图片对应的是一个url索引
举个例子,正如刚才展示列表的哪个图片,语法:
![列表的图片](/列表.png)
输入上面,就出现刚才那个图片啦。
注:
- 本地图片,如果与正在写的这个markdown文档在同目录,就不必写跟目录,就像上面写,就行。
- 若非在同目录,那就必须加入根目录,如:
F:/myBook/StudyWithoutStress/markdown使用教程/列表.png
当然你不怕长,在同目录下,你也可以加上嘛 - 这里还有一个小问题,对于windows操作系统的使用者来说,在这里
复制得到的是:
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还可以画流程图、甘特图、写数学公式等等。
不过这些都不太常用,我们的大脑也没必要储存,还是用的时候在去查吧。
文章未经同意,不得转载哦,违者必究。