写给新手的Markdown快速上手指南
notes, tech

写给新手的Markdown快速上手指南

markdown真的很简单!

590次点击9分钟阅读
新博客用的Sanity,但Sanity原生并不支持Markdown...

一、写在前面

什么是Markdown

维基百科上介绍说:“Markdown是一种轻量级标记语言,创始人为约翰·格鲁伯。它允许人们使用易读易写的纯文本格式编写文档,然后转换成有效的XHTML(或者HTML)文档。”
因为我懒 维基百科的介绍已经很详细了,对于实在不理解的同学,你可以简单地把markdown理解为一种直接用简单的符号就可以完成文章基础排版、层次划分的写作语法
值得一提的是,Markdown并不是一个软件,而是一种写作方式,也就是一套写作语法体系,而借由这点,你也可以很便捷地在多种软件之间享受到一样的书写体验,我也会在文末列出我正在使用的支持markdown的写作软件

为什么要用Markdown

下面我列出几点我个人使用markdown的原因
- 多软件可用(例如Wordpress、Notion、wiki.js、印象笔记、StackEdit…)
- 不过度依赖图形界面,在进行灵感集中输出时更为方便,效率更高 举个例子:我之前写的一篇文章就是用的Wordpress可视化编辑器,说句实在话,不是我故意黑,但是这个“优化后的写作编辑器”与我个人而言还是不好用,说白了就是“效率太低”,用鼠标在界面上点来点去来排版真的不怎么方便
- 快速实现整齐排版
- 手不用在键盘与鼠标之间多次往返,长期写作更舒适
- (我自己的特殊原因)右手骨折,活动范围不大

Markdown有哪些不足(较主观)

1. 基础语法你自己还是要记一点,不然用不来(不过放心,不多且不难)
2. 有些语法其实并不特别方便(例如插入文本超链接、图片与表格)
3. 与其说是“美观的排版”,但其实更接近于规定文章的结构层次划分,没有那么厉害,最终还是得看编辑器的渲染效果,千万不要指望用它来进行精美的排版
4. 最终呈现效果依赖于编辑器渲染,同一篇文章,在不同的编辑器下差别可能会很大

二、基础语法

标题

在当行语句最开头加上井号 # 就是标题,一共有六级,有多少个井号就是几级的标题
注意: 绝大多数语法后面不要忘了加上一个空格来让编辑器识别出来语法格式

段落与文本

直接输入文字就可以直接显示,与word相差无几

但值得一提的是,在markdown中,普通段落换行是如下两种方式
1. 在单行末尾加上两个空格(部分编辑器也可以处理源文件同行内用两个空格换行的,但比较少见)
2. 每行之间单独空一行

同时,如果要对文字进行一些简单的操作,markdown也是可以胜任的
1.倾斜文本 将文本前后用星号 * 包裹起来就可以倾斜被框住的文本
2.加粗文本 将文本前后用两个型号 ** 包裹起来就可以加粗被框住的文本
3.既加粗又倾斜 将文本前后用三个星号 *** 包裹起来就可以实现
4. ~缩小文本(角标)~ 将文本前后用一条波浪线 ~ 包裹起来即可(部分编辑器能渲染此语法)
5.删除线 将文本前后用两条波浪线 ~~ 包裹起来即可

注意:不要忘了加上空格使部分编辑器顺利识别文本中的语法
还有短语段之间的分割线,你只需要单行输入多个短横线就可以了,例如----------(就大多数编辑器而言,大于等于三条)
例子⬇️
----------

列举

首先是无序列举(无标号),一共有两种方式
1. 在单行开头打上 * 并空一格
2. 在单行开头打上 - 并空一格(我比较习惯于这种)

  • 这是第一种方法
  • 这是第二种

其次是有序列举,在单行开头加上如“1.”“2.”等语句,以此类推即可

  1. 第一个
  2. 第二个
  3. 第三个
  4. 还有更多...

同样的,不要忘了加上空格让编辑器识别出语法(如“- ”“1. ”)

表格

说完了列举,我们就来看表格,他的逻辑其实与你在纸上画表格很类似,下面就是一个例子

第一行是表头,第二行用作表头与内容的分割,- 的个数可以调整(大于等于1),第三行及之后是表格内容
具体可以参考图片,文字不容易说清楚:

混进去了奇怪的东西(悲)

插入项目

  1. 插入文本超链接 示例:`[text](https://example.com/)` 链接文本,这种超链接可在段落内直接使用,内容间无需空格也能被正确识别
  2. 插入图片 示例:`![img](https://example.com/example.jpg)` ![](https://static.daoblog.top/5115/icon.jpg) 前者为图片无法加载时使用的占位文本(可略去),后者为图片地址

但说句实在话,这个还是有点繁琐了,所以我一般都直接用PicGo的复制链接功能,传上图床之后就能直接复制markdown格式的链接 其实就是懒

各种引用

markdown里有两种引用,一种是引用文本(块引用),一种是引用代码
1. 块引用 格式:在段首加上大于号 >

这是一个示例

2. 代码(代码引用) 格式:单行代码前后用 ` 框起来, 多行在段前一排与段后一排用```框起来
示例:
print('Hello world!')

数学公式

这个上手就真的有一些难度了,我个人因为极少用到,所以一般都是用一些线上生成器,如果你确实有需要,可以自行查找相关语法
下面有两个例子:
行内公式(部分编辑器支持)
$ {x}^{2}+2xy+{y}^{2}=0 $
$ {x}^{2}+2xy+{y}^{2}=0 $
块公式(部分编辑器支持)
$$ {x}^{2}+2xy+{y}^{2}=0 $$
$$ {x}^{2}+2xy+{y}^{2}=0 $$

三、写在最后

软件推荐

在看完了上面的内容之后的想必你可能已经迫不及待了吧?在了解了基础的写作语法之后你就可以开始尝试着写作了!
在这里我简单地列举一下我所使用的支持markdown语法的软件:

2023年7月注:这个表,图一乐即可

一些想法

懒得升华力,开摆。

相关文章