wordpress 上传图片 出错百度seo和sem
Markdown的一些杂谈
目录
Markdown的一些杂谈
前言
准备工作
认识.Md文件
为什么使用Md?
怎么使用Md?
编辑
怎么看别人给我的Md文件?
Md文件命令
切换模式
粗体、倾斜、下划线、删除线和荧光标记
分级标题
水平线
引用
无序和有序列表
编辑
任务清单
插入链接和图片
内嵌代码和代码块
表格
公式
其他
源代码
预告和回顾
后话
前言
本篇博客将围绕一种常用的文件——Markdown文件来写。由于Markdown以一种类似代码的形式来格式化文本内容,因此可以较为方便地调整你的笔记,让它看上去更加美观一些。
对于Markdown的使用,笔者其实也才刚刚入门,所以如果有写的不对的地方,多多包涵。
准备工作
软件:【参考版本】有道云笔记
官网下载地址https://note.youdao.com/*当然使用Markdown的官方软件也是可以的,但是毕竟是国外的软件,下载和使用不太方便,感兴趣的朋友可以自行了解*
系统版本: Win10/11/其他非Windows版本
*我的电脑是Win10的版本,仅供参考*
认识.Md文件
.md是Markdown文件的标准存储格式,如果之前有VS code的使用经历的话,系统应该默认会使用VS code打开这类文件。
VS code真的很强大,扩展很多,很多文件都可以使用VS code打开。
在VS code的解析下,.md文件应该长这个样子:
*我们待会儿需要使用有道云笔记编辑这类文件,没有VS的朋友也不用着急*
为什么使用Md?
先举个例子吧,现在我们有一段这样的示例文本:
大标题
小标题1
内容1
小标题2
内容2
小标题3
package 某个包
System.out.println("某段示例代码");
这段示例文本由以下四种类型的笔记组成:
- 一级标题
- 二级标题
- 普通文本内容
- 示例代码(这里是一段java代码)
在文本文档中,我们只能做到以下的效果:
可以看到,无论是示例的四种文本中的哪一种,文本文档中显示的内容格式都是完全相同的,没有层次感和优雅的格式。
这时可能会有朋友说,可以用Word来实现示例笔记的效果:
其实说的也没错……
但是我们学前端的,一定绕不开一个名词:超文本标记语言(HyperText Mark Language, HTML) ,关于HTML的相关知识我在其他的博客会讲,现在只需要知晓这个名词。
而Markdown也是一种轻量级的、可由纯文本格式编辑的标记语言。
最主要的是,它可以轻松地转化成HTML语言,而且很多HTML的效果可以直接像在浏览器中的一样,在Md文件中展示出来。
这是因为Md可以直接解释HTML的代码,在网页上呈现笔记的效果。
另外,它也可以转化为常见的word,pdf等文件。
目前,市面上流行的很多写作语言,都是基于Markdown来写的,包括CSDN,Github等论坛。
所以,对于开发者而言,掌握Markdown的基本使用是相当重要的。
我们的示例文字,使用Markdown文件,呈现出来的效果是这样的:
是不是有点博客的味道了? 就作为笔记而言,这样看起来也更加优雅了。
怎么使用Md?
如果是和博主一样,使用有道云笔记,在左侧边栏里按照“全部笔记”->“我的资源”的顺序打开。相对位置如下:
*web学习是我自己的文件夹哈*
右键点击我的资源,按照“我的资源”->“新建”->“Markdown”的顺序创建一个新的Md文件:
下面其实就可以开始编辑了, 但是要确保你在右上角的这个位置选择了“所见即所得”这个模式。
接下来的用法,就和Word和CSDN博客的编写差不多了,直接选文本格式,调成自己喜欢的样子就可以了。
在内容编辑完成之后,回到左侧侧边栏,右键你的Md文件,选择下载即可。
初次使用有道云笔记的朋友需要注意,如果不下载,你的文件是保存在云端的。
如果从本地直接拖一个文件夹进来编辑Md文件,当然是可以的,但是结果是不会自动同步到本地的哈。
怎么看别人给我的Md文件?
现在不少开发者都会使用Md文档来记录东西,就比如说我学习前端的这里,教学编程的老师也喜欢使用Md文件来整理笔记。
这些笔记常常会和代码文件放在一起。如果你在编译器(比如VS code或HbuilderX)里查看代码的时候,想顺带喽一眼笔记的内容,打开可能是下面这个场面:
这个效果显然是不太好的,如果每一篇博文(或者说笔记)都长这个样子,着实有点难受了。
那么,如何正确地查看Md文件呢?
打开有道云笔记,左键单击“我的资源”(或者新建一个文件夹,或者直接从本地拖一个文件夹/复制一个文件夹),可以看到这样一个界面。
直接将目标Md文件从你的资源管理器中拖动到右侧空白区域即可。
这个时候再单击打开,查看Md文件,就可以看到格式排版正确的Md文件了。
*这些HTML的笔记我会在整理完之后分几篇专门的博客来发,有需要的可以期待一下*
Md文件命令
可能很多人看到“标记语言”这种说法,会认为Markdown就是像HTML或者XML那样,需要掌握诸如“标签”、“元数据”等等大量代码有关的东西。
对此我会说,的确,但是其实并没有想象中那么艰难。
首先,就拿有道云笔记来说,即使什么命令都不知道,也可以像正常记笔记、写博客一样编辑Md文件。
其次,就算学,基本的Md命令也并不是很多。下面,我将分享如何学习Md命令。
切换模式
新建一个Markdown文件,在刚刚设置“所见即所得”的地方,将模式切换为分屏编辑:
此时,左侧的黑色区域就是像VS code一样,用来编写代码的地方;右侧则为效果的预览。
特别的,左边区域的主题颜色是可以调整的,点击右上角那个像衣服一样的图标,选一个自己喜欢的颜色即可。我的是tomorrow_night_eighties,仅供参考。
看到最上面的工具栏了吗,我们依次来看每一个选项对应的效果和代码(从左至右)。
粗体、倾斜、下划线、删除线和荧光标记
点击最左边的字母B,它代表的是粗体效果,此时会出现下面这组标签:
** **
这一对标签由两组“**”组成,在他们的中间填上文字(内容),在右侧的预览中就可以看见加粗的效果。
同样的,斜体文字、下划线文字、删除线文字以及荧光标记的代码和对应的效果如下:
* *++ ++~~ ~~== ==
分级标题
在工具栏中,“H”字样代表标题,在下拉菜单中可以选择标题的等级,1~6级的代码和对应的效果如下:
#####################
注意,命令中的#和标题的内容一定要空格分开,否则将无法识别#命令。
水平线
水平线可以用来划分笔记的区域,其代码和对应的效果如下:
---
引用
如果想在笔记中引用一些内容,以单独的区域展示出来,使用的代码和对应的效果如下:
>
也可以在每一行引用内容前都加上“>” ,不过要注意,非引用部分要和引用部分以空行分开。
无序和有序列表
有时,我们还需要在笔记中插入一些列表,用于要点记录内容,这时就可以用到无序和有序列表。
无序列表和有序列表的代码分别如下:
-1.
注意,命令符号和文本之间依然要隔一个空格。
在实际情况中,常常还要用到多级标题。多级标题的方式是,换行,并且按一次tab键(一个\t),然后再使用“ - ”或者“ 数字 + ‘.’ ”,就像下面这样:
- 一级- 二级1. 一级1. 二级12. 二级2
代码和对应效果如下:
任务清单
任务清单,也就是任务是否完成的情况记录,完成了就在方框里面打个勾,实现“未完成项目”和“已完成项目”的命令和效果如下:
- [ ] - [x]
插入链接和图片
如果想在笔记中插入一段链接,也是很好办的,示例代码和效果如下(网址就用CSDN吧):
[这里面是链接显示的文字](这里面填链接的网址)
如果想要插入一张图片,格式和插入链接是类似的,代码和展示的效果如下:

内嵌代码和代码块
在博客开头的例子中,我写了一段Java代码。在博客中,我们也经常可以看见示例代码的区域。
而想要实现这个效果,就需要用到内嵌代码和代码块,其代码和展现的效果如下:
````` ```
*上面一组反单引号是一句代码,下面一组三反单引号是一个代码块*
什么,你问我反单引号怎么输入?英文输入法,看到键盘上面的横排小数字键了吗,按最左边这个键:
表格
表格常常是笔记中不可或缺的一部分,因此还是需要掌握它的代码的,以下面这个4*4的表格为例:
上面颜色略深的部分叫做表头(thead),中间的部分是表身(tbody) ,完成这个表格的代码是这样的:
| | | | |
| --- | --- | --- | --- |
| | | | |
| | | | |
| | | | |
不难理解,两个“ | ”之间的部分就是表格中的内容,“ | --- | ”就是表头和表身的分界线 。
在后面,我们也可以直接使用HTML来完成表格,其实也是很简单的,你甚至可以设置表格的样式,比如大小、边框等,这里就不展开说了。
公式
还记得上面的代码块是如何插入的吗,数学公式的插入和它是差不多的,不过要多一个math标记:
```math
(你的数学公式)
```
类似的,再加上一点代码,我们可以得到一个化学公式:
```math
\ce{你的化学公式}
```
在使用数学公式和化学公式时,常常会用到很多符号。我在下面的表格里列出了几个常用的符号(多的我也不会……):
字母前数字 | 正常显示 |
字母后数字 | 下标 |
^ 加 任意内容 | 上标(用空格结束上标) |
^ | ↑(气体) |
v | ↓ (沉淀) |
= | 生成 |
-> | 动态平衡方程(生成方向右) |
<- | 动态平衡方程(生成方向左) |
博主高考考理综都多少年前了,真不记得哪些符号了……
其他
最后的三项,流程图、时序图、甘特图,其实也可以用代码来写,但是我个人不建议。
我的建议是使用专门绘制这些图的工具,比如Visio等,绘制出相关的图,然后直接用前面所说的插入图片的方式插入。
其实,对于上面的公式,我也建议可以使用MATHTAB等专业的书写公式的工具制作完之后,以图片的形式插入,可以减少工作量,也可以让效果更加美观。
源代码
关于Md案例讲解的全部源代码都放在这里了,有兴趣的可以自己敲敲看。
**加粗文字***斜体文字*++下划线文字++~~删除线文字~~==荧光标记文字==# 标题一## 标题二### 标题三#### 标题四##### 标题五###### 标题六***> 引用的文字1
> 引用的文字2
> 引用的文字3
> 引用的文字4这里就不是引用部分了- 无序一级1- 无序二级1- 无序二级2
- 无序一级21. 有序一级11. 有序二级12. 有序二级2
2. 有序一级2- [ ] 未完成- [x] 已完成[链接替换的文字](https://www.csdn.net/)`我是一句代码````
谁不是啊
我还是一段代码呢
```| | | | |
| --- | --- | --- | --- |
| | | | |
| | | | |
| | | | |```math
E = mc^2
``````math
\ce{2H2O2 = 2H2O + O2 ^}
``````
flowchart LRStart --> Stop
``````
sequenceDiagramparticipant A as Aliceparticipant J as JohnA->>J: Hello John, how are you?J->>A: Great!
``````
gantttitle A Gantt DiagramdateFormat YYYY-MM-DDsection SectionA task :a1, 2014-01-01, 30dAnother task :after a1 , 20dsection AnotherTask in sec :2014-01-12 , 12danother task : 24d
```
预告和回顾
PS系列的有关博客我暂时还没有写完,同时也已经开始写和HTML有关的博客了。下一期可能先会接着出HTML的第一期博客,因为PS第四期的UI博客内容有点多,暂时写不动了……
还是那句话,博主的初心不变,还是以杂谈的形式分享知识,交流心得,并共同进步。
喜欢我的博客风格的朋友,不妨看看我的SVN系列和PS系列的博客:
项目管理 | SVN(全一期)
UI设计 | PS第一期(当前更新到第三期)
后话
笔者也是一个刚刚接触全栈的小白,对于这些东西也是才会使用不久。关于这篇博客,主要是记录一下自己学习的一些经历,然后把自己领悟到的一些东西总结一下,分享给大家。
文章全篇的操作过程都是笔者亲自操作完成的,一些定义性的文字加入了笔者自己的很多理解在里面,所以仅供参考。如果有说的不对的地方,还请谅解。
【H2O2】