Markdown 从入门到入坑(第一阶段)

引言

我们言归正传,那个,你说的那个markdown,它厉害吗?

它不是厉不厉害的问题,它真的是那种......那种用起来很舒服的那种。它的语法特别简单,功能超级多,支持H5标签,很强大,遗憾的是你们都不知道,什么是markdown

什么是 Markdown

Markdown 是一种可以使用普通文本编辑器编写的标记语言,通过简单的标记语法,它可以使普通文本内容具有一定的格式

Markdown 学习

对于 Markdown 呢,我个人觉得可以分为三个阶段。当然,我自己也只是停留在第二个阶段,第三个阶段的功能只是需要的时候才去百度

当然,工欲善其事,必先利其器 。我们在学习 Markdown 的时候,同时也需要一个超强力的编辑器:Typora 。如果不想下载编辑器的小伙伴也不慌,我们依然可以在掘金简书CSDN等网站上申请个账号然后去编写自己的 Markdown 文章

是不是没想到,我们经常看的掘金掘金、简书、csdn竟然大部分都是用 Markdown 写的

腾讯文档也已经支持 Markdown 语法了,足以证明其之强大

话不多说,下面我们就来看看到底什么是 Markdown 吧

第一阶段

这第一阶段呢,适用于一般大众,仅仅会一些简单的基础语法就可以了

标题

大家知道 word 里面分一二三级标题,同理,Markdown 在写文章的时候也分为一共6级标题。而在 Markdown 里面,不需要像 word 那么麻烦设置标题等级

  • 一级标题:在段落前添加一个#和一个空格,然后后面接一级标题内容。例:# 一级标题
  • 二级标题:在段落前添加两个#和一个空格,然后后面接二级标题内容。例:## 二级标题
  • 三四五六级标题同理,一般用到6级就够了

快捷键:标题

当然,在一般的 Markdown 编辑器里,都是支持快捷键的,设置n级标题的快捷键为:Ctrl + 数字n(这里注意不是小键盘)

加粗、倾斜

在 word 里面,我们经常使用字体加粗倾斜 来对某些文字进行重点标记。Markdown 里面字体加粗倾斜也是超级简单的,话不多说,直接上教程:

  • 加粗:在需要加粗的句子前后或词语前后分别添加**,例:**加粗**会被解析为加粗
  • 倾斜:在需要倾斜的句子前后或词语前后分别添加*,例:*倾斜*会被解析为倾斜
  • 加粗且倾斜:emmm,就是三个*,例:***加粗且倾斜***会被解析为加粗且倾斜

快捷键:加粗、倾斜

  • 加粗为Ctrl + B
  • 倾斜为Ctrl + I

链接、图片

我们写个人博客的时候,很多时候都会添加一些链接、图片。Markdown 添加链接和图片的语法很相似,所以我把他们放到了一起:

  • 链接:语法规则为[网页描述](网址链接)
  • 图片:语法规则为![图片描述](图片链接)

图片的语法规则只是在链接的前面添加一个 ! ,所以我说他们很相似

这里注意,链接可以为本地的链接,甚至可以是相对链接

快捷键:链接、图片

  • 链接为Ctrl + K
  • 图片的快捷键各个编辑器不一致

列表

添加列表也是一个必不可少的功能,其中列表包括:有序列表无序列表,下面是他们的语法

  • 有序列表:在组成有序列表的前面添加序号.即可,例:
Markdown 复制代码
1. 有序列表1
2. 有序列表2

会被解析为

  1. 有序列表1
  2. 有序列表2

似乎没有啥变化.....所以有序列表吧,大家自行解决就行

  • 无序列表:在组成有序列表的前面添加-+*中的任意一种即可,例:
Markdown 复制代码
- 无序列表1
- 无序列表2

会被解析为

  • 无序列表1
  • 无序列表2

列表的额外内容

列表一般也会分等级,在 Markdown 里面可以通过不同的tab缩进来进行列表等级划分,例:

Markdowm 复制代码
- 等级一1
	- 等级二1
	- 等级二2
		- 等级三
- 等级一2
  • 等级一1
    • 等级二1
    • 等级二2
      • 等级三
  • 等级一2

引用

这个引用虽然我自己好像没有怎么正儿八经用,但是偶需要的人肯定会用到。这里还是简单说一下

引用语法:在要引用的行前添加>即可,例如:

Markdowm 复制代码
> 这是引用的文字
> 引用内可以嵌套标题、列表等

解析为

这是引用的文字

引用内可以嵌套标题、列表等

表格

表格这个先放例子吧,看例子就懂了

Markdowm 复制代码
| Item      |    Value | Qty  |
| :-------- | --------:| :--: |
| Computer  | 1600 USD |  5   |

上面是一个最简单的表格的例子,会被解析为:

Item Value Qty
Computer 1600 USD 5

最简单的表格代码都需要三行,其中第一行是标题行,第二行表示文字对齐方向,然后第三行及以后才是数据

表格每一列均以|隔开,每一行均以换行符隔开

第二行表示的文字对齐方向规则如下:

左对齐只有左侧有一个冒号,后面接N个-,N>1

右对齐只有右侧有一个冒号,前面接N个-,N>1

居中对齐左侧右侧同时有一个冒号,中间接N个-,N>1

代码

代码这个一般也就程序员来用吧,当然,代码这个东西后面还可以玩出更新鲜的花样,Markdown 的高级使用有一方面就是在代码里面的使用

代码分为行内代码和代码区块,分别介绍:

  • 行内代码:把行内代码用 ` 包围起来,注意这个符号是英文输入法下的键盘上 tab 键上面、数字 1 左面的那个符号
  • 代码区块:把代码块用三个 ` 包围起来,详情看下面的例子。
1562841423666

解析为

printf("hello world"); //行内代码

java 复制代码
public static void main(String...args){
	System.out.println("hello world"); //代码块
}

代码块注意一下,三个 ` 以后接的是编程语言类型,一般常用的都支持,甚至还会有语法高亮

相关推荐
Source.Liu11 小时前
【BuildFlow & 筑流】品牌命名与项目定位说明
c++·qt·rust·markdown·librecad
siaikin3 天前
基于 Astro Starlight 的多框架文档
前端·vue.js·markdown
深海的鲸同学 luvi4 天前
【HarmonyOS】原生 Markdown 渲染解决方案 —— @luvi/lv-markdown-in
华为·harmonyos·markdown·原生渲染
secondyoung14 天前
Markdown转换为Word:Pandoc模板使用指南
开发语言·经验分享·笔记·c#·编辑器·word·markdown
Source.Liu15 天前
【mdBook】6 在持续集成中运行 mdbook
markdown
Source.Liu17 天前
【mdBook】5.5 mdBook 特色功能
markdown
Source.Liu18 天前
【mdBook】7.1 预处理器
markdown
Source.Liu19 天前
【mdBook】5.2.3 渲染器配置详解
markdown
Source.Liu21 天前
【mdBook】5.2 配置
markdown
Source.Liu21 天前
【mdBook】1 安装
笔记·rust·markdown