文章目录
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
图片
图片的语法格式如下:
![图片的名字,加载不出来会显示](图片的路径或者图片的链接 "图片的名字,鼠标移上去会显示")
例如:
![无尘](https://i-blog.csdnimg.cn/blog_migrate/7aa8e56fcbd637e4b4b29cc5aed14e2d.png "无尘")
表现如下图所示:
如果要调整图片大小,typora不会直接支持调整,如果要更改,可以借助html的语法,图片标签
例如:
<img src="https://i-blog.csdnimg.cn/blog_migrate/7aa8e56fcbd637e4b4b29cc5aed14e2d.png" width = "60%">
表现如下图所示:
![](https://i-blog.csdnimg.cn/blog_migrate/7aa8e56fcbd637e4b4b29cc5aed14e2d.png)
可以给图片增加链接
即把原来的用方括号括起来,然后再加上圆括号写上链接
例如:
[![无尘](https://i-blog.csdnimg.cn/blog_migrate/7aa8e56fcbd637e4b4b29cc5aed14e2d.png "无尘")](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文件
无尘有着隐族和凡人的双重血脉,所以在他展示出自己能力前,在隐族弟子间曾备受欺凌。直到他成为了隐族首领万象的弟子,这种情况才略有好转。曾经的苦难化为了无尘参悟天地奥秘的动力,无尘相信,自己才是能真正破除永劫的那个人。 ↩︎