markdown 使用教程

Markdown使用教程

Markdown是什么?

Markdown是一种轻量级标记语言,可以让我们用简单的标记符号来编写简洁清爽的文档,并且可以很方便的转换成其他格式,比如html,pdf等等,方便分享。这篇文章就是用markdown写的

Markdown的优点

  1. 不是编程语言,语法非常简单,只需要记住几个符号就可以开始编写文档。不需要花很多时间学,一小时就足够。
  2. Markdown可以很方便地转换为HTML、PDF等格式,方便分享和发布。
  3. 用markdown写文档只是熟练度的问题,熟练之后,写文章超快,而且排版整洁美观,简洁清爽,比word好用多多。 (word用起来太烦了,反正我用不来word)
  4. 像语雀、印象笔记等大部分笔记软件都支持markdown语法,可以方便的将笔记转移到另一个笔记软件。像github等也支持markdown语法。
  5. 便于管理,不容易丢,只需对md文件进行copy保存,就能保证所有笔记的完整。

为什么推荐使用markdown?

  1. markdown就是专门记笔记用的,可以这么理解。基本大型的笔记软件都支持markdown语法,像typora(一款超好用的笔记软件)
  2. 说实话,现在不用markdown会被歧视,看不起的,因为真的很普及。

    这篇文章是我边学markdown边写的,因为周围人都在用,所有我觉得我也得学学qaq

  3. 不学也不行,因为周围人都在用,你看他们分享的资料全是markdown写的,要是纯看md文件,你看不懂qaq
  4. markdown确实好用,写笔记快。我有朋友用markdown写完再上传到hexo做个人博客的,好厉害#QAQ 我也想试试

Markdown基本用法

可以这么说,markdown就是让你写文档,写文章的时候脱离鼠标,全身心把注意力放在键盘上。

再看基本语法前,不如先找个markdown编辑器,比如typora,边学边写。
建议先跳到下面用vscode写markdown部分,等安装完插件后,再在vscode上实践语法,可以边学边写。


标题

就是多个#+空格(下用space指代)

几个#就是几级标题,比如:

三级标题

四级标题

五级标题
六级标题

段落换行

直接enter即可
此外,空一行,或者多行渲染后的效果都是空一行。自己看着办


强调

强调分两种,一种是 斜体,一种是 粗体。当然还有 粗斜体
斜体 一个下划线或者*,习惯后者

标题

就是多个#+空格(下用space指代)

几个#就是几级标题,比如:

三级标题

四级标题

五级标题
六级标题

段落换行

直接enter即可

但有时候没用,看编辑器的设定把

此外,空一行,或者多行渲染后的效果都是空一行。自己看着办


强调

强调分两种,一种是 斜体,一种是 粗体。当然还有 粗斜体
斜体 一个下划线或者,习惯后者
粗体 两个下划线或者
*

注意:
斜体和粗体之间不能有空格,否则会渲染失败
*号前最好还是加个空格。


列表

有序列表和无序列表,有序列表就是数字+点+空格,无序列表就是*+空格,或者-+空格,或者+空格。比如:

有序列表

  1. 第一项
  2. 第二项
  3. 第三项

无序列表

  • 第一项
  • 第二项
  • 第三项

插入图片

有两种方法:

  1. 把要用的图片放在和md一个文件夹下,然后直接写图片名即可,比如:
    ![图片名称](imageFile.png)

    图片名称是指放在鼠标放在图片上显示的字样,imageFile.png是指图片的文件名,注意图片名和文件名要一致,否则会找不到图片。

小熊
小熊


  1. 如果下载了Paste Image插件,直接复制图片,然后在文档中,按ctrl+alt+v即可,会自动生成图片和图片链接。

链接

链接可以连接到网上某个url网址,如果是下面这个语法:
[链接名称](url)

链接名称是指鼠标放在链接上显示的字样,url是指链接的网址。

例如我自己部分参考的markdown教程:点击这里 对应的视频: 点击这里

此外,可以直接选中某个字,直接ctrl+v即可,会自动生成链接,例如:
alt text


引用

句子前加>,比如:
>这是一段引用

这是一段引用


代码块

代码块有两种,一种是单行代码,一种是多行代码。

  1. 行内代码,用``括起来即可,比如:
    这是一段行内代码

  2. 多行代码,用三个`括起来即可,比如:

    1
    2
    3
    这是一段多行代码
    这是一段多行代码
    这是一段多行代码

表格

表格用|分割,比如:
alt text

姓名 年龄 性别
张三 18
李四 19
王五 20

另外还有个简单的玩法:Markdown Tables Generator表格生抽器

在这里你可以把word,excel里面的表格直接粘贴到网页中,然后生成对应的整齐的Markdown表格:
alt text


分割线

用—即可


删除线

~~删除线内容~~即可,比如:
这是一段删除线


下划线

<u>这是一段下划线</u>即可,比如:
下划线内容


当然,markdown还有很多其他的功能,例如集成LateX语法的公式等等,需要可以自行了解。

如果想要了解公式,可参考这里

在vscode中使用markdown

vscode

vscode大家应该都知道,是一款非常强大的 编辑器 ,对的。它 不是编程平台 ,所以不要怕,它支持markdown语法,并且有很多插件,可以让我们的markdown编写文档更方便。
vscode下载地址:点击这里 一路安装next即可

安装相关的插件

运行vscode后,点击左侧的插件市场,搜索插件名称,点击安装,即可使用:
alt text

  1. Markdown All in One 方便在vsocde中编写markdown文档
  2. Markdown PDF可将markdown文档转换为pdf格式,便于看不懂markdown语法的人看
  3. Markdown Preview Enhanced markdown预览插件,支持很多功能,比如数学公式,代码高亮等等
  4. Paste Image 可支持将照片直接粘贴进markdown,极大简化编写。
  5. Code Spell Checker 检查拼写错误,防止打错字,主要检查的是英文单词

建立你的文库和第一篇文章

  1. 首先你要建立一个 仓库 用来存放你所有的文章,这样你的文章就不会丢了。这个非常简单,在你的 硬盘上建个文件夹 ,就结束了,对就这么简单,以后你所有的文章都放在这个文件夹中,要备份的话只要复制这个文件夹就可以复制你所有的文章了。

  2. 创建你的第一篇文章:

    1. 用vscode打开这个文件夹(可以在资源管理器中选择打开文件夹),即 MYFLOGS
    2. 在这个文件夹下面创建一个子文件夹,起个名字,即 MarkDown_Usage
    3. 再这个文件夹下面创建一个文件,扩展名是md,即 usage.md 每一篇文章就是一个文件夹,用在该md文章的图片也放在该文件夹同一目录下:

alt text

  1. 写作时,记得经常保存,这是个好习惯,快捷键ctrl+s 当然系统也会提示

如何预览markdown格式

可以打开分屏浏览:

alt text

进入zen mode模式,即沉浸式写代码

快捷键:ctrl+k,松开后,再按z,即可进入。两下esc即可退出
alt text
非zen mode
alt text
zen mode

写完后生成目录

快捷键:ctrl+shift+p,输入Create Table of Content,回车即可生成目录:(不知道为什么有点丑陋)
alt text
alt text


至此,你已经学会了如何在vscode中编写markdown文档了,是不是很简单呢?后续可转为pdf等等.

当然,在vscode中编写的md文件,可以用其他任何支持markdown语法的编辑器打开,比如typora,所渲染的内容完全一样,笔记转移很方便~


用typora写markdown

当然,如果你觉得vscode的markdown预览功能太弱,你可以试试typora,一款非常强大的markdown编辑器,不用像vscode那样写完要打开预览页面查看,而是 实时渲染 ,真正实现所见即所得。
但是,现在已经 收费 了#QAQ (可以找找破解版qaq,富哥另说)

大部分人都用typora来记笔记,但是当字数过多后,typora会发生卡顿(听说),但好评还是很高的.
想要学习的话,可以参考这里
还有参考视频


总结

至此,基本的markdown写作你已经会了,要用好这些工具,提高自己的生产效率.加油打工人!


markdown 使用教程
http://example.com/2024/08/19/Markdown_usage/
作者
GarlicBa
发布于
2024年8月19日
许可协议