白丁轶事 - FMoran's Blog

为什么你需要学习使用 Markdown 语法

随着步入大学,笔记与写作的全面电子化,平常写文档的同时对文字排版和储存的要求越来越高,传统的富文本txt已经无法再满足我的需求。

Markdown缘起

翻看我的锤子便签,第一次接触Markdown语法还是在初中,使用Markdown语法写的第一篇日记是那时去农村采摘橘子,那时国内互联网上没找到对Markdown语法支持较好的笔记平台,锤子便签并不支持Markdown语法的实时预览,导致现在回看那篇日记,语法写得磕磕绊绊的。对那位老板的印象仅剩下他瞎了一只眼睛,人很朴实,是云南人,上世纪流放来江西,在这边呆习惯之后便在这安了家,索性就不回去了。

Markdown的概念

Markdown 是一种采用纯文本格式语法的轻量级标记语言。它的设计允许将其转换为多种输出格式,但最初的同名工具仅支持 HTML。 Markdown 常用于格式化自述文件、撰写在线论坛信息,以及使用纯文本编辑器创建丰富的文本。

Markdown已经成为许多写作平台和网站的标准文档格式。在一些博客引擎中,Markdown 最终会被转译为 HTML 元素。在Stack Overflow、Reddit等网站中,使用Markdown语法可以让你的内容排版更加美观和便于阅读。

Markdown 还被 GitHub 指定为 README 专用的文档格式,GitHub中的每一个目录下的README.md文件都会被当成是当前目录的解释文件,显示在详情页上。

学习使用Markdown语法的好处

简单易学

Markdown语法相对简单,学习曲线较为平缓。它采用了简洁的标记符号,比传统的排版方式更容易理解和掌握,无需专门的编辑器或工具支持,只需使用纯文本编辑器即可。

跨平台兼容

Markdown文档可以在几乎所有的文本编辑器和Markdown编辑器中打开和编辑,而且可以在不同的操作系统和设备上无缝协作。这种跨平台兼容性使得Markdown成为了一种非常便捷的文档格式。

格式一致性

Markdown语法定义了一套简单的标记规则,可以轻松地创建一致的文档格式。无论是制作简单的文本文档、笔记、博客文章,还是创建复杂的网页、报告、演示文稿,都可以使用Markdown语法实现一致的格式。

易于维护性

Markdown文档是纯文本格式,不像Word或其他排版软件那样包含大量的样式和格式信息。因此,Markdown文档更易于版本控制和维护,可以直接用版本控制系统(如Git)进行管理。

Markdown基础语法

Markdown 文档的后缀名是.md

标题

在一行文字前写1~6个#号,当前行会被当成标题来处理。1个#号表示1级标题,字号在标题中最大;6个#号表示6级标题,字号在标题中最小。标题会加粗处理,并且单独占领一行。

# 这是一级标题
## 这是二级标题
### 这是三级标题
#### 这是四级标题
##### 这是五级标题
###### 这是六级标题

实现效果为

这是一级标题

这是二级标题

这是三级标题

这是四级标题

这是五级标题
这是六级标题

字体

下面展示的是一些字体的写法。

**加粗的文字两边用两个 * 包围**
*倾斜的文字两边用一个 * 包围*
***加粗倾斜的文字两边用三个 * 包围***
~要加删除线的文字两边用 ~ 包围~

实现效果为

加粗的文字两边用两个*包围

倾斜的文字两边用一个*包围

加粗倾斜的文字两边用三个*包围

要加删除线的文字两边用两个``包围~~

引用

引用的文字使用 > 来开始,下面的一段都会被显示为引用形式。例如

这段是引用文字

如果需要多行,可以在引用中使用 <br>来折行。

> 第一行 <br >第二行

第一行
第二行

如果内容太多,则需要使用 <blockquote> 标签,在这个标签中的所有内容都会被显示为引用的形式。

<blockquote>  
这段文字  



无论换多少行都是引用  
</blockquote>  

这段文字

无论换多少行都是引用

而且,引用的同时还可以和其他标记同时使用。

>## 引用里放了个二级标题

引用里放了个二级标题

引用可以使用多级

> 引用
>> double 引用

引用

double 引用

分割线

使用 >= 3个的 * 或 - 号都可以表示一个分割线。

------

******

下边是两条分割线



列表

使用 + - * 来表示无序列表,符号和内容之间要有一个空格

+ 列表
- 列表
* 无序列表

使用任意数字来表示有序列表时,数字和内容之间需要有一个空格。数字顺序并不会影响列表实际的数字顺序。

1. 第一个
2. 第二个
3. 第三个
6. 即使写的是6实际上还是4
  1. 第一个
  2. 第二个
  3. 第三个
  4. 即使写的是6实际上还是4

链接

使用[链接显示内容](链接地址)来表示一个点击了会跳转的超链接。

[淘宝](http://www.taobao.com)

淘宝

图片

使用![图片描述](图片地址)来表示一个图片,这里我以我的头像来举例。

![](https://bear-images.sfo2.cdn.digitaloceanspaces.com/fmoran-1713192517-0.png)

推荐一些常用的Markdown语法教程

如果你在学习了以上Markdown基础语法之后想更深一步学习Markdown语法,以下是我推荐的一些常见的语法教程:

  1. Markdown 官方文档Markdown Guide 提供了全面的Markdown语法教程,适合初学者和有经验的用户。
  2. GitHub Markdown 教程GitHub Flavored Markdown Spec 是GitHub的Markdown语法规范,介绍了Markdown在GitHub上的一些扩展功能,如任务列表、表格等。
  3. Markdown Cheat SheetMarkdown Cheat Sheet 是一个Markdown语法速查表,提供了Markdown的基本语法和常用语法示例,方便用户快速查阅。
  4. CommonMark Markdown 教程CommonMark Spec 是一个标准化的Markdown语法规范,提供了对Markdown语法的详细解释和示例。
  5. Typora Markdown 教程Typora Documentation 是Typora编辑器的官方文档,提供了对Markdown语法的详细解释和Typora编辑器的使用方法。

这些教程都可以帮助你快速学习和掌握Markdown语法,根据自己的需求选择合适的教程进行学习。

无论你喜欢使用什么样的方式写作,适合自己的才是最好的。

#2024 #技术