markdown 使用教程
Markdown使用教程
Markdown是什么?
Markdown是一种轻量级标记语言,可以让我们用简单的标记符号来编写简洁清爽的文档,并且可以很方便的转换成其他格式,比如html,pdf等等,方便分享。这篇文章就是用markdown写的
Markdown的优点
- 不是编程语言,语法非常简单,只需要记住几个符号就可以开始编写文档。不需要花很多时间学,一小时就足够。
- Markdown可以很方便地转换为HTML、PDF等格式,方便分享和发布。
- 用markdown写文档只是熟练度的问题,熟练之后,写文章超快,而且排版整洁美观,简洁清爽,比word好用多多。 (word用起来太烦了,反正我用不来word)
- 像语雀、印象笔记等大部分笔记软件都支持markdown语法,可以方便的将笔记转移到另一个笔记软件。像github等也支持markdown语法。
- 便于管理,不容易丢,只需对md文件进行copy保存,就能保证所有笔记的完整。
为什么推荐使用markdown?
- markdown就是专门记笔记用的,可以这么理解。基本大型的笔记软件都支持markdown语法,像typora(一款超好用的笔记软件)
- 说实话,现在不用markdown会被歧视,看不起的,因为真的很普及。
这篇文章是我边学markdown边写的,因为周围人都在用,所有我觉得我也得学学qaq
- 不学也不行,因为周围人都在用,你看他们分享的资料全是markdown写的,要是纯看md文件,你看不懂qaq
- markdown确实好用,写笔记快。我有朋友用markdown写完再上传到hexo做个人博客的,好厉害#QAQ 我也想试试
Markdown基本用法
可以这么说,markdown就是让你写文档,写文章的时候脱离鼠标,全身心把注意力放在键盘上。
再看基本语法前,不如先找个markdown编辑器,比如typora,边学边写。
建议先跳到下面用vscode写markdown部分,等安装完插件后,再在vscode上实践语法,可以边学边写。
标题
就是多个#+空格(下用space指代)
几个#就是几级标题,比如:
三级标题
四级标题
五级标题
六级标题
段落换行
直接enter即可
此外,空一行,或者多行渲染后的效果都是空一行。自己看着办
强调
强调分两种,一种是 斜体,一种是 粗体。当然还有 粗斜体
斜体 一个下划线或者*,习惯后者
标题
就是多个#+空格(下用space指代)
几个#就是几级标题,比如:
三级标题
四级标题
五级标题
六级标题
段落换行
直接enter即可
但有时候没用,看编辑器的设定把
此外,空一行,或者多行渲染后的效果都是空一行。自己看着办
强调
强调分两种,一种是 斜体,一种是 粗体。当然还有 粗斜体
斜体 一个下划线或者,习惯后者
粗体 两个下划线或者*
注意:
斜体和粗体之间不能有空格,否则会渲染失败
*号前最好还是加个空格。
列表
有序列表和无序列表,有序列表就是数字+点+空格,无序列表就是*+空格,或者-+空格,或者+空格。比如:
有序列表
- 第一项
- 第二项
- 第三项
无序列表
- 第一项
- 第二项
- 第三项
插入图片
有两种方法:
- 把要用的图片放在和md一个文件夹下,然后直接写图片名即可,比如:
![图片名称](imageFile.png)
图片名称是指放在鼠标放在图片上显示的字样,imageFile.png是指图片的文件名,注意图片名和文件名要一致,否则会找不到图片。
小熊
- 如果下载了
Paste Image
插件,直接复制图片,然后在文档中,按ctrl+alt+v即可,会自动生成图片和图片链接。
链接
链接可以连接到网上某个url网址,如果是下面这个语法:[链接名称](url)
链接名称是指鼠标放在链接上显示的字样,url是指链接的网址。
例如我自己部分参考的markdown教程:点击这里 对应的视频: 点击这里
此外,可以直接选中某个字,直接ctrl+v即可,会自动生成链接,例如:
引用
句子前加>,比如:>这是一段引用
这是一段引用
代码块
代码块有两种,一种是单行代码,一种是多行代码。
行内代码,用``括起来即可,比如:
这是一段行内代码
多行代码,用三个`括起来即可,比如:
1
2
3这是一段多行代码
这是一段多行代码
这是一段多行代码
表格
表格用|分割,比如:
姓名 | 年龄 | 性别 |
---|---|---|
张三 | 18 | 男 |
李四 | 19 | 女 |
王五 | 20 | 男 |
另外还有个简单的玩法:Markdown Tables Generator表格生抽器
在这里你可以把word,excel里面的表格直接粘贴到网页中,然后生成对应的整齐的Markdown表格:
分割线
用—即可
删除线
用~~删除线内容~~
即可,比如:这是一段删除线
下划线
用<u>这是一段下划线</u>
即可,比如:
下划线内容
当然,markdown还有很多其他的功能,例如集成LateX语法的公式等等,需要可以自行了解。
如果想要了解公式,可参考这里
在vscode中使用markdown
vscode
vscode大家应该都知道,是一款非常强大的 编辑器 ,对的。它 不是编程平台 ,所以不要怕,它支持markdown语法,并且有很多插件,可以让我们的markdown编写文档更方便。
vscode下载地址:点击这里 一路安装next即可
安装相关的插件
运行vscode后,点击左侧的插件市场,搜索插件名称,点击安装,即可使用:
- Markdown All in One 方便在vsocde中编写markdown文档
- Markdown PDF可将markdown文档转换为pdf格式,便于看不懂markdown语法的人看
- Markdown Preview Enhanced markdown预览插件,支持很多功能,比如数学公式,代码高亮等等
- Paste Image 可支持将照片直接粘贴进markdown,极大简化编写。
- Code Spell Checker 检查拼写错误,防止打错字,主要检查的是英文单词
建立你的文库和第一篇文章
首先你要建立一个 仓库 用来存放你所有的文章,这样你的文章就不会丢了。这个非常简单,在你的 硬盘上建个文件夹 ,就结束了,对就这么简单,以后你所有的文章都放在这个文件夹中,要备份的话只要复制这个文件夹就可以复制你所有的文章了。
创建你的第一篇文章:
- 用vscode打开这个文件夹(可以在资源管理器中选择打开文件夹),即 MYFLOGS
- 在这个文件夹下面创建一个子文件夹,起个名字,即 MarkDown_Usage
- 再这个文件夹下面创建一个文件,扩展名是md,即 usage.md 每一篇文章就是一个文件夹,用在该md文章的图片也放在该文件夹同一目录下:
- 写作时,记得经常保存,这是个好习惯,快捷键
ctrl
+s
当然系统也会提示
如何预览markdown格式
可以打开分屏浏览:
进入zen mode模式,即沉浸式写代码
快捷键:ctrl
+k
,松开后,再按z
,即可进入。两下esc
即可退出
非zen mode
zen mode
写完后生成目录
快捷键:ctrl
+shift
+p
,输入Create Table of Content
,回车即可生成目录:(不知道为什么有点丑陋)
至此,你已经学会了如何在vscode中编写markdown文档了,是不是很简单呢?后续可转为pdf等等.
当然,在vscode中编写的md文件,可以用其他任何支持markdown语法的编辑器打开,比如typora,所渲染的内容完全一样,笔记转移很方便~
用typora写markdown
当然,如果你觉得vscode的markdown预览功能太弱,你可以试试typora,一款非常强大的markdown编辑器,不用像vscode那样写完要打开预览页面查看,而是 实时渲染 ,真正实现所见即所得。
但是,现在已经 收费 了#QAQ (可以找找破解版qaq,富哥另说)
大部分人都用typora来记笔记,但是当字数过多后,typora会发生卡顿(听说),但好评还是很高的.
想要学习的话,可以参考这里
还有参考视频
总结
至此,基本的markdown写作你已经会了,要用好这些工具,提高自己的生产效率.加油打工人!