写给新手的Markdown快速上手指南
markdown真的很简单!
阅读原生Markdown版本,请点击此处
同时推荐以下视频
一、写在前面
什么是Markdown
在维基百科上介绍说:“Markdown是一种轻量级标记语言,创始人为约翰·格鲁伯。它允许人们使用易读易写的纯文本格式编写文档,然后转换成有效的XHTML(或者HTML)文档。”
因为我懒 维基百科的介绍已经很详细了,对于实在不理解的同学,你可以简单地把markdown理解为一种直接用简单的符号就可以完成文章基础排版、层次划分的写作语法
值得一提的是,Markdown并不是一个软件,而是一种写作方式,也就是一套写作语法体系,而借由这点,你也可以很便捷地在多种软件之间享受到一样的书写体验,我也会在文末列出我正在使用的支持markdown的写作软件
为什么要用Markdown
下面我列出几点我个人使用markdown的原因
-
多软件可用(例如Wordpress、Notion、wiki.js、印象笔记、StackEdit…)
-
不过度依赖图形界面,在进行灵感集中输出时更为方便,效率更高
举个例子:我之前写的一篇文章就是用的Wordpress可视化编辑器,说句实在话,不是我故意黑,但是这个“优化后的写作编辑器”与我个人而言还是不好用,说白了就是“效率太低”,用鼠标在界面上点来点去来排版真的不怎么方便 -
快速实现整齐排版
-
手不用在键盘与鼠标之间多次往返,长期写作更舒适
-
(我自己的特殊原因)右手骨折,活动范围不大
Markdown有哪些不足(较主观)
-
基础语法你自己还是要记一点,不然用不来(不过这都能难到你的话,我只能说你有点懒…)
-
有些语法其实并不特别方便(例如插入文本超链接、图片与表格)
-
与其说是“美观的排版”,但其实更接近于规定文章的结构层次划分,没有那么厉害,最终还是得看编辑器的渲染效果,千万不要指望用它来进行精美的排版
-
最终呈现效果依赖于编辑器渲染,同一篇文章,在不同的编辑器下差别可能会很大(例如热铁盒网页托管渲染的与印象笔记渲染的效果差别就比较大)(非恰饭)
二、基础语法
标题
在当行语句最开头加上井号 # 就是标题,一共有六级,有多少个井号就是几级的标题
注意: 大多数语法后面不要忘了加上一个空格来让编辑器识别出来语法格式
段落与文本
直接输入文字就可以直接显示,与word相差无几
但值得一提的是,在markdown中,普通段落换行是如下两种方式
-
在单行末尾加上两个空格(部分编辑器也可以处理源文件同行内用两个空格换行的,但比较少见)
-
每行之间单独空一行
同时,如果要对文字进行一些简单的操作,markdown也是可以胜任的
-
倾斜文本 将文本前后用星号 * 包裹起来就可以倾斜被框住的文本
-
加粗文本 将文本前后用两个型号 ** 包裹起来就可以加粗被框住的文本
-
既加粗又倾斜 将文本前后用三个星号 *** 包裹起来就可以实现
-
缩小文本(角标) 将文本前后用一条波浪线 ~ 包裹起来即可(部分编辑器有此语法)
-
删除线将文本前后用两条波浪线 ~~ 包裹起来即可
注意:不要忘了加上空格使编辑器顺利识别文本中的语法
还有短语段之间的分割线,你只需要单行输入多个短横线就可以了,例如“----------”(就大多数编辑器而言,大于等于三条)
例子⬇️
列举
首先是无序列举(无标号),一共有两种方式
-
在单行开头打上 * 并空一格
-
在单行开头打上 - 并空一格(我比较习惯于这种)
- 这是第一种方法
- 这是第二种
其次是有序列举,在单行开头加上如“1.”“2.”等语句,以此类推即可
-
第一个
-
第二个
-
第三个
-
还有更多...
同样的,不要忘了加上空格让编辑器识别出语法(如“- ”“1. ”)
表格
说完了列举,我们就来看表格,他的逻辑其实与你在纸上画表格很类似,下面就是一个例子
姓名 | 性别 | 年龄 | 职业 | 住址 |
---|---|---|---|---|
李田所 | 男 | 24 | 学生 | 日本东京下北泽 |
御坂美琴 | 女 | 14 | 学生 | 日本学园都市 |
老颜 | 男 | 14 | 学生 | 盒打击是吧,芝士计划的一部分! |
xxx | x | xx | xxx | xxxxxxxxxxxxxx |
第一行是表头,第二行用作表头与内容的分割,- 的个数可以调整(大于等于1),第三行及之后是表格内容
具体可以参考图片,文字不容易说清楚:
混进去了奇怪的东西(悲)
插入项目
-
插入文本超链接
示例:[text](https://example.com/)
链接文本,这种超链接可在段落内直接使用,内容间无需空格也能被正确识别 -
插入图片
示例:![img](https://example.com/example.jpg)
前者为图片无法加载时使用的占位文本(可略去),后者为图片地址
但说句实在话,这个还是有点繁琐了,所以我一般都直接用PicGo的复制链接功能,传上图床之后就能直接复制markdown格式的链接 其实就是懒
各种引用
markdown里有两种引用,一种是引用文本(块引用),一种是引用代码
- 块引用
格式:在段首加上大于号右半边 >
这是一个示例
- 代码(代码引用)
格式:单行代码前后用 ` 框起来,
多行在段前一排与段后一排用```框起来
示例:
print('Hello world!')
print('Hello world!')
print("An Example")
print('''We are studying Python at school. I don't kown why. ''')
数学公式
这个上手就真的有一些难度了,我个人因为极少用到,所以一般都是用一些线上生成器,如果你确实有需要,可以自行查找相关语法
下面有两个例子:
行内公式(部分编辑器支持)
$ {x}{2}+2xy+{y}{2}=0 $
$ {x}^{2}+2xy+{y}^{2}=0 $
块公式(部分编辑器支持)
$$ {x}^{2}+2xy+{y}^{2}=0 $$
三、写在最后
软件推荐
在看完了上面的内容之后的你想必已经迫不及待了吧?在了解了基础的写作语法之后你就可以开始尝试着写作了!
在这里我简单地列举一下我所使用的支持markdown语法的软件:
名称 | 推荐指数 | 类别 | 平台 | 特点 | 官网 |
---|---|---|---|---|---|
Wordpress | ⭐⭐ | 博客软件 | 自行搭建网页端 | 开源 新版对Markdown的兼容性是个谜,不再推荐 | 官网(简中) |
Typecho | ⭐⭐⭐ | 博客软件 | 自行搭建网页端 | 开源 轻量化、生态佳,上手有门槛 | 官网(简中) |
Notion | ⭐⭐⭐ | 多用途 | 全平台 | 闭源 功能强大,上手有门槛,免费,没有官方中文 | 官网(En) |
flowus | ⭐⭐⭐ | 多用途 | 全平台 | 闭源 功能强大,有门槛,免费,国内公司,懂得都懂 | 官网(简中) |
印象笔记 | ⭐⭐⭐⭐⭐ | 笔记类软件 | 全平台 | 闭源 功能强大,界面美观,但免费版功能有限 | 官网(简中) |
为知笔记 | ⭐⭐⭐⭐ | 笔记类软件 | 全平台 | 半开放 可自建服务,官方服务免费100天 | 官网(简中) |
Wiki.js | ⭐⭐⭐ | 知识库 | 自行搭建网页端 | 开源 免费好用的知识库,上手有门槛,要自行搭建 | 官网(En) |
Gitbook | ⭐⭐ | 多用途 | 网页端 | 偏闭源 中国大陆间歇性访问,纯英文 | 官网(En) |
Gridea | ⭐⭐⭐⭐⭐ | 静态站点生成器 | 电脑端 | 开源 功能强大,界面美观,上手门槛较低 | 官网(简中) |
Hexo | ⭐⭐⭐⭐ | 静态站点生成器 | 电脑端 | 开源 功能强大,基于命令行,不适合新手 | 官网(简中) |
hugo | ⭐⭐⭐⭐ | 静态站点生成器 | 电脑端 | 开源 功能强大,基于命令行,生态略差 | 官网(En) |
话说WP对Markdown表格的支持又歇菜了......
一些想法
懒得升华力,开摆。