MarkDown基础
介绍
MarkDown格式应该是一个程序员必备的技能了吧,是我们在写作的一大利器。支持Markdown格式的编辑器也很多,我经常使用的就只有VScode和Typora,这两个算是各有优缺点。
VScode的预览格式是在右边单独分出来一栏来进行实时预览写作效果,左边还是代码部分,效果如下:
而Typora的预览是直接在本文档生成文档效果,结果如下:
具体效果可以自己去试试哦,之前一直用着VScode但是碍于屏幕较小,分成两个屏幕有些东西预览的时候不好看效果,后来经过同事推荐,才知道Typora这个超级轻量的编辑器,而且也支持Linux、Windows和Mac。
所以本篇文章是基于Typora来写markdown语法的,但是语法是通用的哦,除了一些特有的功能
安装
我用的是基于Ubuntu的Linux发行版,所以安装很简单:
1 | # sudo apt-key adv --keyserver keyserver.ubuntu.com --recv-keys BA300B7755AFCFAE |
或者下载源码进行编译安装,其他安装方式请参考:
特有功能和配置
主题
Typora支持非常多的主题,甚至可以自己去设计属于自己的主题。
这里是官方的主题:http://theme.typora.io/
在这里可以根据官方文档进行自己安装、配置和制作主题
特有配置
在设置里可以自己自定义非常多关于自己的喜好设置
更多请自己去探索哦,真的很强大。
在新版Typora里可以设置图片通过PicGo一键上传图床功能,很方便呢
语法
标题
标题是用”#”号来进行标记的,一个代表h1到六个代表h6,后面记得要加一个空格,并且会自动生成目录。
1 | ## 这是h1标题 |
效果如下:
注意左边的大纲里也会生成相应的目录哦
引用内容
我们经常需要引用一些东西,格式如下
1 | > 这里是提示内容 |
效果如下:
列表
列表分为无序和有序列表,格式分别为:
1 | ### 无序 |
序号之后是有空格的哦
效果:
任务列表
任务列表就是内容前面加上勾选的选项,显示这个任务的状态。
1 | ### 未选中状态 |
效果如下:
代码块
代码块的符号,就是键盘上ESC下面那个键,和波浪线是同一个键,就是” `` “这个符号,格式:
1 | ``` |
效果如下:
单行代码只用一个反引号包住代码即可。
表格
表格比较复杂,标记符号就是通道符” | “,格式如下:
1 | | 第一格 | 第二格 | 第三格 | |
效果:
标准格式:虚线上方为标题栏:
1 | | First Header | Second Header | |
效果:
表格内容居中:
1 | | Left-Aligned | Center Aligned | Right Aligned | |
效果:
脚注
脚注是指当鼠标移动到该单词时显示对该词的注释,格式如下
1 | You can create footnotes like this[^footnote]. |
效果:
链接
对指定文字进行超链接:
1 | [This link](http://example.net/) |
效果:
另一种链接:
1 | This is [an example][id] reference-style link. |
效果:
普通链接:
1 | <https://www.laugh0608.online> |
插入图片
代码:
1 | ![Alt text](/path/to/img.jpg) |
既可以引用本地文件,但是更推荐使用图床工具,即使是图片链接也可以实时预览哦 前提是你要有网
例如:
文字斜体和加粗
格式如下:
1 | * 内容 * //加粗 |
效果:
其他通用语法
换行
在Typora里换行直接可以敲一个回车即可,但是在其他编辑器或者Github里,换行是有严谨的格式的,就是每一个段落的后面必须加上两个空格和一个回车才能换行,或者说中间空一行。例如:
删除线
有时候我们需要删除一些东西,但是又不能完全删除,还需要一些参考意义,就可以使用到删除线:
1 | ~~ 内容 ~~ |
类似于这样:
转义符
文字缩进空格是不行的,因为空格和tab在markdown里都是标记,所以要用到转义符,所有的转义符都可以使用HTML格式: