博客、Github的md文件的写法
可用 Typora这个软件作为编写markdown的软件,不同的软件或平台对语法的优化不同,但常用的几个基本不变。
基础用法
一、标题
多少个#号代表标题的级数,一级标题一个#,是最大的标题,注意,#号与文字标题之间要有空格。
横线
三个减号然后回车,表示分割线
斜体
两个星号包裹文本,注意,*号和文本之间没有空格
加粗
两边各两个星号包裹文本,注意,**号和文本之间没有空格
标记文本
两边各两个等号包裹文本,注意,==号和文本之间没有空格
删除文本
两边各两个波浪号包裹文本,注意没有空格,波浪号在键盘Tab键的上方。演示中再加一个空格是为了好看清楚删除符号
引用文本
一个大于号 >,然后加一个空格,然后加文本,注意,大于号放在行首,该行前面不能出现任何文本和符号,在最后空一行空行表示引用结束
下标和上标
下标 ,两个波浪号包裹文本,如 下~标~,注意没有空格。
上标,两个尖角符号包裹文本,如 上^标^,注意没有空格。
该功能在Typora中没有,但其它地方可能有
文本样式可以与标题镶嵌使用,如下面的标题,使用了标题、标记和斜体
列表(符号)
一个-减号、或+加号、或*星号都能表示一个列表,注意符号和文本之间有一个空格,且符号前面没有文本和其它符号,符号必须是在文首。这里的演示只用了减号
列表(数字)
计划任务
计划任务的写法 - [ ] 计划任务1 ,注意除了和上面的三个相同外,还要注意每个符号之间都有一个空格
完成任务的写法 - [x] 完成任务3 ,注意点和上面的三个相同,但是中括号和x没有空格,x小写大写都可以
链接
一对中括号包裹文本,然后在后面用一对小括号包裹要跳转的地址https://www.baidu.com,注意符号之间没有空格
代码片
三个反引号然后加上使用的语言,可以不写语言类型,写完代码后,新行三个反引号作为结束符。反引号是Tab键的上面那个键
如果不写语言类型,如python,name就没有关键字高亮显示。下面演示中Typora自动帮我在尾部添加结束符
表格
第一行用竖号作为分隔符,分隔多个列,两个竖号之间写文字,如果不写文字就要使用空格作为占位符,然后第二行还是用竖号作为分隔符,但是中间夹的是减号,最少有一个减号,第三行或N多行都是和第一行一样
在演示中,软件帮我们做了优化,有很多细节看不到,下面看写的截图
然后再看对应的预览
注脚
注脚就是对一个词语的解释,点击即可跳到解释处,也可点击解释处会跳到注脚处。
在要做注脚的后方加
光[^xxx]
把注脚的解释放到其他地方,然后再注释的前面加符号
[^xxx]:奥特曼
高级用法
Markdown语法支持HTML标签,下面只演示p标签
目录。在CSND中只需要在空白行使用符号目录。在CSND中只需要在空白行使用符号@[TOC],就会自动生成目录,但是在typora软件中不支持,我们可以使用html的a标签模拟出这个效果
有时想用下划线,但是Markdown没有,我们也是使用html的u标签模拟
Markdown还支持数学公式,但我不懂
Typora更多玩法
主题
一、使用里面内置的几个主题,喜欢哪个使用哪个
二、使用网络上的主题
- 到https://theme.typora.io/寻找喜欢的主题并下载。
- 比如我下载了一个主题,并解压。得到类似下面这些文件
- 打开任意md文件,在typora软件中依次点击文件>偏好设置>外观>打开主题文件夹。
- 把刚刚下载解压好的文件除README.md文件外,全部拷贝到上一步打开的文件目录。
- 重启Typora,就可以在主题哪里看到Solarized和Solarized Dark这两个主题了
导出
导出支持多种格式
比如HTML类型,首先在Typora中看到的是这样的
导出后,在浏览器打开文件看到的是这样的