markdown入门教程

作为本网站上传的第一份笔记，这一篇文章自然得介绍最好用最简单的语言：Markdown。

本教程的目的只有一个：用最简单的方式，暴力地灌输关于Markdown的语法。Markdown是很好用的做笔记的语言，学会Markdown以后，你将可以顺畅地在电脑上做笔记。

当然Markdown的作用不止于此，在github上的许多文件，包括我的这篇文章，都需要使用Markdown语法；在本篇文章下的评论也支持Markdown语法。

不过大家不用担心学不会，Markdown本身是非常简单的语言，很贴近我们日常生活的语法。大家有时间的话，稍微拿出几十分钟来了解一下，保证你快速上手！

本教程所有内容来自于B站UP主“毛怪的学习日记”的视频《【全网最详细Markdown入门使用教程】40分钟教会你用免费的vscode做出好看的笔记》，我是跟着这个视频学的，大家可以给他三连支持一下。

一、准备工作

1. 安装vscode

   [vscode官网下载地址]https://code.visualstudio.com/

2. 下载必要的插件

   以下是需要安装在vscode中的一些插件，可以在插件处搜索：

   • Markdown All in One
   • Markdown Preview Enhanced
   • Markdown PDF（不是很推荐）
   • Paste Image

3. 创建.md文档，打开同步预览功能，开始编辑

二、基本语法

1. 标题

   使用#号引出标题。例如：

   #一级标题

   ##二级标题……

   注意：一定要#号后面接一个空格！不然效果就像上文这样，没法显示标题样式。

2. 引用

   用一个>引出引用，语法为：>这一句被引用了。效果如下：

   芝士雪豹。——丁真

3. 列表

   i. 无序列表，也即不标序号的分点，语法是- 这是无序列表。可以用-，+，*三种符号引出，效果是一样的。

   • 用-引出的列表
   • 用+引出的列表
   • 用*引出的列表

   我还是更喜欢用-号，毕竟不用按shift键。注意符号后面依然需要带一个空格。

   ii. 有序列表，就是现在的1.2.3.4….。值得一提的是，如果序号不连续，系统会自动识别并替换成连续的数字。

   iii. 嵌套，如现在的i.ii.iii，就是嵌套的结果。嵌套在代码中依旧是写123，但需要使用缩进，系统会自动识别嵌套列表并更换样式。

   iv. TodoList

   格式是- [ ] ...。注意中括号之间要空格，后文也要空格。不过我不知道这玩意有什么卵用，估计只是用于自己的任务清单吧。

   • 学习markdown
   • 使用markdown
   • 吃晚饭

4. 表格

   通过 | 来分隔表格中的不同内容。初始默认居中对齐，可以在一行上方用:----表示左对齐，:----:表示居中对齐。标注对齐标志是构建表格的必要部分。

   | 左对齐 | 居中对齐 | 右对齐 |
   | :---- | :----: | ----: |
   a|b|c
   

   这段代码在导出后的样子是：

   左对齐	居中对齐	右对齐
   a	b	c

5. 段落

   • 分隔线？——使用***。效果就不展示了，反正就是一条分割线，这里用的话会打乱文章结构。大家可以自行尝试。

   • 字体

     字体	代码
     斜体	* *
     ==高亮==	== ==
     粗体	** **
     斜粗体	** **
     删除线	~~ ~~
     下划线	<u> </u>

   • 脚注

     格式：[^数字]。效果如下：

     请大家给我点点关注¹谢谢喵！

6. 代码

   使用`符号成对包裹代码块，单行代码用一个，多行代码用三个。效果如下：

   #include<bits/stdc++.h>
   using namespace std;
   int main(){
       cout << "hello world" << endl;
       return 0;
   }
   

   或者单行：printf("hello world");

7. 超链接

   • 直接展示网址名。例如：更多教程参考以下网站：https://www.runoob.com/markdown/md-link.html

   • 也可以类似于脚注的形式，格式是[显示文字](实际链接)。效果如下：

     更多教程点击链接。

8. 图片

   借助图床保存：https://imgse.com/ ，可以实现不上传图片原件即可在线访问。不过图床可能会崩，慎用。

   该网站会提供markdown代码，直接copy过来就好了。

   可以直接使用html语言，它的好处在于调整图片大小和位置功能。具体见html教程。（以后会更新的）

   也可以用Markdown语法：![替代文本](图片地址)，其中替代文本指的是如果没找到图片，会显示的文本。

三、其他操作

• 插入latex公式

  • 行内显示公式：用$符号。如下:

    $ f(x) = kx + b $

  • 用一大块显示数学表达式：用$$符号。如下：

    $$
    \begin{Bmatrix}
    a & b \\
    c & d
    \end{Bmatrix}
    $$
    

    这同时还有居中的效果。

    我的网站无法显示latex公式，大家可以自行复制代码到自己的Markdown文件中，然后预览。理论上是可以显示的。

• html/css语法

  • ctrl+shift+p 搜索“Markdown Preview Enhanced: Customize CSS”, 在style中使用css语法改标题格式等。

• 个性化设置

  File-Preferences-Settings

四、导出为PDF文档

• 右击预览部分-Open in Browser-另存为PDF文档
• 或是右击预览部分-Export-Chrome-PDF。这是我现在使用的方式。

五、总结

以上就是教程的全部内容！希望大家能够掌握这项技能，或许能让你的笔记事半功倍！

1. B站关注我哦 ↩