文章目录
Markdown语法整理
自钱孔入 而钱不湿 我亦无他 唯手熟尔 ------------《卖油翁》
入手须知
Markdown是一种轻量级的标记语言,与word不同,markdown非所见即所得
编辑器推荐: VS coed(有了插件,VS coed适合任何编程语言),Typora(强烈推荐),notion(notion部分语法不支持)
注意： 本教程是基于Typora的，部分可能属于扩展语法，其他编辑器无法支持，但是基础部分应该是完全没有问题的。
当然word的使用寄巧也要学会,毕竟大学生交作业,交报告还是用word比较多.但是如果交PDF的话,吼吼吼吼🐶
为什么要使用 Markdown？
当你可以通过按下界面中的按钮来设置文本格式时，为什么还要使用 Markdown 来书写呢？使用 Markdown 而不是 word 类编辑器的原因有：
- Markdown 无处不在。StackOverflow、CSDN、掘金、简书、GitBook、有道云笔记、V2EX、光谷社区等。主流的代码托管平台，如 GitHub、GitLab、BitBucket、Coding、Gitee 等等，都支持 Markdown 语法，很多开源项目的 README、开发文档、帮助文档、Wiki 等都用 Markdown 写作。
- Markdown 是纯文本可移植的。几乎可以使用任何应用程序打开包含 Markdown 格式的文本文件。如果你不喜欢当前使用的 Markdown 应用程序了，则可以将 Markdown 文件导入另一个 Markdown 应用程序中。这与 Microsoft Word 等文字处理应用程序形成了鲜明的对比，Microsoft Word 将你的内容锁定在专有文件格式中。
- Markdown 是独立于平台的。你可以在运行任何操作系统的任何设备上创建 Markdown 格式的文本。
- Markdown 能适应未来的变化。即使你正在使用的应用程序将来会在某个时候不能使用了，你仍然可以使用文本编辑器读取 Markdown 格式的文本。当涉及需要无限期保存的书籍、大学论文和其他里程碑式的文件时，这是一个重要的考虑因素。
冷知识:CTRL+句号 可以使输入时输入的标点符号,间隔符以英文输入法的形式输入
例如中文。，；【】对应的英文格式.,;[]
为什么要补充这个? hh,markdown里面转义字符全是英文的
Markdown的应用扩展和高级应用比较多,很难一次性全部掌握,但是没有关系,先从基础语法部分开始,慢慢学习,半小时之内,基础语法必定能形成肌肉记忆
下面 话不多说 开始吧.
基础部分
标题
h1 h2 h3 h4 h5 h6 一共有六级标题,几个#就是几级标题,最后一个#用空格与标题内容隔开
-
例如
# Markdown语法 ## 基础部分 ### 标题 ......
段落
段落与段落之间用空白一行隔开,不使用tab首行缩进
换行
在一行的末尾添加两个或多个空格，然后按回车键,即可创建一个换行,换行用HTML的标签是br(<br>),或者手动键入(<br>)标签.(html的语法)
强调
*xxxxx* 将一段文字两端用一个*号包起来是倾斜,**xxxxxx** 两个*号包起来是加粗,***xxxxxxx*** 三个*号包起来是加粗并倾斜
例如:
- 无空
- 无空
- 无空
引用
用大于号和文本以空格相隔 例如 > 无牵无挂 无空无敌
表现如下(注:大于号前面不能有文字)
无牵无挂 无空无敌
可以相互嵌套使用,也可以和其他标记符嵌套使用
例如:
> > 无牵无挂 无空无敌
>
> - 无牵无挂 无空无敌
>
> **无牵无挂 无空无敌**
表现如下:
无牵无挂 无空无敌
- 无牵无挂 无空无敌
无牵无挂 无空无敌
列表
有序列表
在每个列表项前添加数字并紧跟一个英文句点,然后以空格和后面的内容相隔,数字不必按数学顺序排列,但是列表应当以数字 1 起始.
1. wukongcodes.com
2. 无牵无挂 无空无敌
3. 我身无拘 武道无穷
表现如下
- wukongcodes.com
- 无牵无挂 无空无敌
- 我身无拘 武道无穷
无序列表
每个列表项前面添加破折号 (-),星号 (*) 或加号 (+) .缩进一个或多个列表项可创建嵌套列表.但不要在一串列表中混合使用这些符号
- wukongcodes.com
- 无牵无挂
+ 无空无敌
+ 欲戴王冠
* 必承其重
表现如下:
- wukongcodes.com
- 无牵无挂
- 无空无敌
- 欲戴王冠
- 必承其重
其中列表可以嵌套子列表,使用方法是回车后按backspace 然后再输入-,*或者+.同样有序列表也是类似
- wukongcodes.com
- 无牵无挂
- 悟空无敌
表现如下:
-
wukongcodes.com
- 无牵无挂
- 悟空无敌
- 无牵无挂
-
当然也可以和引用元素">",代码块等嵌套,如下所示
-
代码
代码块
代码块的使用是包围在两个反引号``内
如果代码里面包含反引号那么就包含在四个反引号内````
例如:
`code`
``Use `code` in your Markdown file.``
表现如下:
code
Use `code` in your Markdown file.
某种语言的代码
用三个或三个以上反引号开头然后输入语言的名字回车,以一段C语言为例
#include<stdio.h>
int mian{
for(int i=0;i<999;i++){
print("wukong")
}
}
#当然了代码有很多错误,嘻嘻,欢迎指正
公式
多用于论文写作当中，Markdown中的公式语法是遵循LaTex的，所以我们可以用在线的转化工具把我们想要的数学公式转化成LaTex的语法:
一般公式分为两种形式，行内公式和行间公式。
（这部分可能部分markdown编辑器不支持，但是typora是支持的（不过需要手动在设置中打开）,以下是以typora为例）
-
行内公式：用两个美元符号包围
例如:
$ \Gamma(z) = \int_0^\infty t^{z-1}e^{-t}dt\,. $表现效果:$ \Gamma(z) = \int_0^\infty t{z-1}e{-t}dt,. $
-
行间公式：用四个美元符号包围,用法：输入两个$$后回车
例如:
$$ \Gamma(z) = \int_0^\infty t^{z-1}e^{-t}dt\,. $$表现效果:
Γ ( z ) = ∫ 0 ∞ t z − 1 e − t d t . \Gamma(z) = \int_0^\infty t^{z-1}e^{-t}dt\,. Γ(z)=∫0∞tz−1e−tdt.
具体公式里面的那些寄分,极限,求和等符号怎么用,不做讲解,别问,问就是不会😓
分割线
单独一行上使用三个或多个星号 (***),破折号 (---) 或下划线 (___) ,并且不能包含其他内容.
例如:
***
表现如下:
删除线
在单词前后使用两个波浪号~~
例如:
~~无空~~无敌
表现如下:
无空无敌
链接
链接的语法如下:(其中双引号内的超链接title可写可不写,链接title是当鼠标悬停在链接上时会出现的文字,这个title是可选的,它放在圆括号中链接地址后面,跟链接地址之间以空格分隔)
[超链接显示名](超链接地址 "超链接title")
例如:
[无空同学的个人博客](http:www.wukongcodes.com "WK_Blog")
表现如下:
使用尖括号可以很方便地把网址或者email地址变成可点击的链接
例如:
<http:wukongcodes.com>
<3542314824@qq.com>
表现如下:
**注意：**某些编辑器会自动把网址变成链接，即使没有方括号包围，这种情况下，如果不希望这样自动转换，可以将网址用反引号包围变成代码块的形式。
当然如果一个链接出现了很多次那么,为了方便修改和阅读,你可以把这个链接写成引用链接的形式,简单来讲就是这样的形式[无空同学的博客][1]，第一个方括号内显示名字，第二个方括号内是一个类似于标签的东西，这个标签的名字可以是数字，字母，单词等；然后在文章结尾或者段落的结尾写上这个标签的内容。[1]:http:www.wukongcodes.com "WK_Blog".
例如:
[无空同学的个人博客][blog]
[blog]:http:www.wukongcodes.com "WK_Blog"
表现如下:
另外,还可以改变样式
- 倾斜 -->
*[无空同学的个人博客](http:www.wukongcodes.com "WK_Blog")* - 加粗 -->
**[无空同学的个人博客](http:www.wukongcodes.com "WK_Blog")** - 代码 -->
[`无空同学的个人博客`](http:www.wukongcodes.com "WK_Blog")
这些样式之间的嵌套,不做讲解,自己摸索嘞😈
圆括号内也可以是目录的名字,可以实现在文档内部跳转
例如:[转到标题位置](#标题)
效果:转到标题位置
脚注
脚注的目的是为了添加注释,可以实现点击跳转到注释的位置(注释一般写在文章结尾),脚注的格式 第一部分添加的地方加上[^1],当然可以是其他数字,字母,单词等标识符但是不能包含空格.文章末尾或者任何其他想要跳转的地方[^1]:注释的内容,在方括号后加上冒号即可
例如:
无牵无挂,无尘无敌[^1]
[^1]: 无尘有着隐族和凡人的双重血脉，所以在他展示出自己能力前，在隐族弟子间曾备受欺凌。直到他成为了隐族首领万象的弟子，这种情况才略有好转。曾经的苦难化为了无尘参悟天地奥秘的动力，无尘相信，自己才是能真正破除永劫的那个人。(这一部分放在文章结尾)
表现如下:
无牵无挂,无尘无敌1
图片
图片的语法格式如下:
例如:
表现如下图所示:
如果要调整图片大小,typora不会直接支持调整,如果要更改,可以借助html的语法,图片标签
例如:
<img src="https://img.166.net/reunionpub/ds/kol/20220111/022103-gcaydsl935.png?imageView&tostatic=0&thumbnail=1500x0" width = "60%">
表现如下图所示:
可以给图片增加链接
即把原来的用方括号括起来,然后再加上圆括号写上链接
例如:
[](http:www.wukongcodes.com)
表现如下图:
对于图片可能较为麻烦，如果是本地路径的话，把md文件发给别人别人可能就看不到图片，但是pdf等格式是没有问题的，但是发pdf的话，无疑丧失了md文件简单微小的优点，毕竟图片内存还是要比文本大。
转义
要显示原本用于格式化 Markdown 文档的字符,需要在字符前面添加反斜杠字符.
例如:\* \# \[]..
表现为:* # []…
还有很多符号,具体可以查看官方文档
内嵌HTML标签
这里对学过或者了解前端的比较友好
可以在文档里随意使用HTML的标签,这样的话,对于图片的大小,文字的颜色等更为多样,易操作
行级內联标签
HTML 的行级內联标签如 <span>、<cite>、<del> 不受限制，可以在 Markdown 的段落、列表或是标题里任意使用。依照个人习惯，甚至可以不用 Markdown 格式，而采用 HTML 标签来格式化。例如：如果比较喜欢 HTML 的 <a> 或 <img> 标签，可以直接使用这些标签，而不用 Markdown 提供的链接或是图片语法。当你需要更改元素的属性时（例如为文本指定颜色或更改图像的宽度），使用 HTML 标签更方便些。
HTML 行级內联标签和区块标签不同，在內联标签的范围内， Markdown 的语法是可以解析的。
例如:
This **word** is bold. This <em>word</em> is italic.
表现如下:
This word is bold. This word is italic.
区块标签
区块元素──比如 <div>、<table>、<pre>、<p> 等标签，必须在前后加上空行，以便于内容区分。而且这些元素的开始与结尾标签，不可以用 tab 或是空白来缩进。Markdown 会自动识别这区块元素，避免在区块标签前后加上没有必要的 <p> 标签。
例如，在 Markdown 文件里加上一段 HTML 表格：
This is a regular paragraph.
<table>
<tr>
<td>无空</td>
</tr>
</table>
This is another regular paragraph.
表现如下:
This is a regular paragraph.
| 无空 |
This is another regular paragraph.
请注意，Markdown 语法在 HTML 区块标签中将不会被进行处理。例如，你无法在 HTML 区块内使用 Markdown 形式的*强调*。
任务列表
创建带有复选框的项目列表可以用破折号和方括号,其中方括号和破折号中间有空格 - [X]
其中方括号内有X是选中状态,把X用空格代替即为非选中状态- [ ].
例如:
- [X] 计算机网络
- [x] 计算机组成原理
- [ ] 编译原理
表现如下:
- 计算机网络
- 计算机组成原理
- 编译原理
表格
使用三个或多个连字符（---）创建每列的标题，并使用管道（|）分隔每列
例如:
| 无空 | 无敌 |
| ---------- | ----------- |
| Header | Title |
| Paragraph | Text |
表现如下:
| 无空 | 无敌 |
|---|---|
| Header | Title |
| Paragraph | Text |
对齐
在标题行中的连字符的左侧，右侧或两侧添加冒号（:），将列中的文本对齐到左侧，右侧或中心
例如:
| 无空 | 无敌 | 无牵无挂 |
| :---------- | :--------: | ----------:|
| Header | Title | Text |
| 左对齐 | 居中 | 右对齐 |
表现如下:
| 无空 | 无敌 | 无牵无挂 |
|---|---|---|
| Header | Title | Text |
| 左对齐 | 居中 | 右对齐 |
可以在表格中设置文本格式 例如 可以添加链接,代码(仅反引号``中的单词或短语,而不是代码块)
不能添加标题、块引用、列表、水平规则、图像或HTML标签
注意:
在列表的时候,不经常使用这种管道符来列表,我们可以直接在在线的markdown表格生成器中编辑,然后把源码复制过来.这里列举一个在线的生成器
表情
两种方法可以将表情符号添加到Markdown文件中：将表情符号复制并粘贴到Markdown格式的文本中，或者键入emoji shortcodes
复制和粘贴表情符号
可以简单地从 Emojipedia 等来源复制表情符号并将其粘贴到文档中。
使用表情符号简码
键入表情符号短代码来插入表情符号。这些以冒号开头和结尾，并包含表情符号的名称
例如:
真好笑！ :joy:
表现如下:
真好笑！ 😂
注：可以使用此表情符号简码列表
进阶部分
有了基础部分的讲解，如果真的自己摸索过了，那么基本的文档编辑应该就不成问题了。因为markdown本质上是支持前端HTML的标签语法，如果你是前端高手🐶，那么完全可以把markdown当作前端页面来写，这样的话那些格式样式完全由你自己掌握，这样的话进阶部分根本不是为题。所以,我们的进阶部分主要以Typora、Markdown和HTML结合起来，你可以利用HTML标签自己定义字体大小颜色等，进一步帮助我们写出更美观，简洁的文章。
进阶部分主要讲解以下几点，这也是我在使用的过程中发现的痛点
图床使用
当Typora要插入图片时，插入本地的图片时，转发给别人，别人就看不到了，所以为了方便我们将图片上传到图床使图片变成在线的链接，我们可以使用在线图床的方式，这里不便于过多展示，可以参考以下两篇博客的说明
- Typora配合PicGo和七牛云实现图床 - 掘金 (juejin.cn)
- https://onestar.newstar.net.cn/blog/65
图床的使用有很多，有阿里云，腾讯云，七牛云，又拍云等等，具体使用哪一种看个人条件，七牛云又拍云需要已备案的域名，阿里云需要付费，不过一年不到10元还是很合算的。
后续有空会写图床的具体配置方法，但是还是建议自己摸索一下，可以提高整合搜集解决问题的能力。笔者使用的是七牛云的图床。
图片排版
图片排版还是用HTML里面的img标签，详情可参考这篇博客(57条消息) Typora_Markdown_图片排版(总)_An_Lord的博客-CSDN博客_markdown图片排版
文本对齐
-
靠左
<div align = "left">这里输入要靠左的字体</div> -
居中
<div align = "ceter">这里输入要居中的字体</div>或者<center>这里输入要居中改的字体</center> -
靠右
<div align = "right">这里输入要靠右的字体</div>
Typora的使用
Typora你完全可以把他当作浏览器来用，可以去自定义自己的CSS样式，或者从官网上下载各种各样的主题，或者在GitHub上下载各种各样的模板和字体。例如，vue这个主题就是非常不错的，还有来自GitHub的latex主题，该项目已经在GitHub收获2.9k star。当然，还是那样子，如果你是前端高手，可以自己手撸一个自己个性化的样式。
Typora我愿称之为地表最强。现在是买断制，开始收费了，不过仍然可以下载以前的版本或者测试版，或者dddd，有各种各样的破解版本，但是还是建议支持正版，毕竟89元买断制也不是特别贵。（人家作者从来也没说过免费，只不过作者追求完美，一直在完善😂）
点击访问Typora中文站
下面来整理一些Typora的使用技巧.
更换主题
菜单栏：文件->偏好设置->外观->主题->获取主题
然后把下载好的文件放到主题文件夹下面即可,具体主题看具体的安装教程.
YAML Front Matter
Typora 现在支持 YAML Front Matter 。 在文章顶部输入 --- 然后按 Enter 键将引入一个，或者从菜单中插入一个元数据块。(段落->YAML Front Matter )
你可以在里面写上,文章的标题,作者,时间,文章内图片的来源等信息
注：只能是文章顶部,其他位置不可以,会转义成下划线.
换行
段落只是一行或多行连续的文本。在 markdown 源代码中，段落由多个空行分隔。在Typora中，只需按下 Return 即可创建新段落。
按 Shift + Return 可创建单个换行符。但是，大多数 markdown 解析器将忽略单行中断，要使其他 markdown 解析器识别你的换行符，可以在行尾留下两个空格，或者插入 <br/>.
目录
输入 [toc] 然后按 Return 键将创建一个“目录”部分，自动从文档内容中提取所有标题，其内容会自动更新。
嵌入内容
有些网站提供基于iframe的嵌入代码，也可以将其粘贴到Typora中
例如：B站的视频就提供了代码,点击分享–>嵌入代码,即可复制粘贴到Typora
扩展语法
如图所示，需要把那些选项勾中才能使用上下标，高亮等扩展语法。注意，每次设置完必须重启Typora。
模板使用
可以去网上搜集各种各样的模板供自己使用，诸如结课报告，生活记录等
有些排版的非常好，建议使用借鉴，但要标明出处，注意开源精神！
导出PDF分页
有时候我们需要在某个位置分页，那么只需要在该位置加一行HTML代码，那么后面的内容就会另起一页
代码如下：
<div style="page-break-after:always;"></div>
导出word
如果你已经正确安装好pandoc并且也在typora中设置好了路径，但是导出的时候还是会有奇奇怪怪的问题，可以尝试用命令行来导出word文件，（你可能还需要把pandoc手动添加到系统的环境变量）。
pandoc -s 输入文件名.md -o 输出文件名.docx
总结
以上就是笔者在使用Markdown编辑器Typora的一些心得，当然不可能全覆盖，每个人在写文档时都有自己的习惯和风格，本文只是在介绍整理一些使用技巧，目前只了解这么一些，会越来越完善以后用到的。
彩蛋
安利一款非常好用的在线markdown排版工具，可以用来发布文章，在多个平台（微信公众号，csdn，知乎等），具体使用方法自己摸索，应该是非常简单而且非常好用，聪明的你应该是一看就会。
注：来自鱼皮大佬的视频如何高效写出优质文档？提高自学编程、程序员工作效率的法
这是工具的网址Markdown | 让排版变 Nice (mdnice.com)
路径，但是导出的时候还是会有奇奇怪怪的问题，可以尝试用命令行来导出word文件，（你可能还需要把pandoc手动添加到系统的环境变量）。
pandoc -s 输入文件名.md -o 输出文件名.docx
总结
以上就是笔者在使用Markdown编辑器Typora的一些心得，当然不可能全覆盖，每个人在写文档时都有自己的习惯和风格，本文只是在介绍整理一些使用技巧，目前只了解这么一些，会越来越完善以后用到的。
彩蛋
安利一款非常好用的在线markdown排版工具，可以用来发布文章，在多个平台（微信公众号，csdn，知乎等），具体使用方法自己摸索，应该是非常简单而且非常好用，聪明的你应该是一看就会。
注：来自鱼皮大佬的视频如何高效写出优质文档？提高自学编程、程序员工作效率的法
这是工具的网址Markdown | 让排版变 Nice (mdnice.com)
关注公众号 Coder无空即可获取本篇博客md文件及相应pdf文件
无尘有着隐族和凡人的双重血脉，所以在他展示出自己能力前，在隐族弟子间曾备受欺凌。直到他成为了隐族首领万象的弟子，这种情况才略有好转。曾经的苦难化为了无尘参悟天地奥秘的动力，无尘相信，自己才是能真正破除永劫的那个人。 ↩︎
650
被折叠的 条评论
为什么被折叠?
到【灌水乐园】发言
