欢迎您访问程序员文章站本站旨在为大家提供分享程序员计算机编程知识!
您现在的位置是: 首页

我的第一篇MarkDown博文——MarkDown语法

程序员文章站 2022-07-15 17:05:25
...

Hello Blog World!

1.题记

这是本人所写的第一篇博客,也是第一次使用MarkDown撰写的文稿。
我的博客,旨在记录一些在我编程开发的工作和学习过程中,所收获的知识,和遇到难题后的思考和解决方案。

由于之前只是用md阅读文本,所以其实对md脚本语言了解的也比较少。但是听闻其实蛮简单,所以希望自己也可以尽快掌握吧,可以尽快写出格式漂亮、条理清晰的博客。

2.MarkDown语法

虽然是第一篇试验性博客,但也还是写一写内容吧。打算就先熟悉、总结一下md的一些语法和标签的用法吧。


根据Github上younghz/Markdown的总结

Markdown语法主要分为如下几大部分: 标题,段落,区块引用,代码区块,强调,列表,分割线,链接,图片,反斜杠 \,符号’ ` ’。

那么我们就据此一一来展示一下,并当做练习了。

2.1 标题

标题的标记主要用两种方式标记

  • =-的方式
  • #的方式

2.1.1 =-方式标记标题

在标题文字下一行输入=-分别可将上方文字标记成一级标题和二级标题。如:

一级标题

==

二级标题

效果为

一级标题

二级标题


在上述内容输入的过程中,发现输入一个或多个=-都可以实现对标题的标记。意外之处在于,当=输入三个或以上时、-在输入四个或以上时,表内内容在编辑器中的格式也会对应改变(3/4个以下时和普通文本格式一致)。

本人使用的编辑器是Mac OSX下的MacDown软件

2.1.2 #方式标记标题

#标记标题就相对简单了,在标题内容前,输入几个#就会将后面的文字标记成几级标题。如:

#一级标题

##二级标题

###三级标题

####四级标题

#####五级标题

######六级标题

效果为

一级标题

二级标题

三级标题

四级标题

五级标题
六级标题

经试验,最高支持到六级标题。

2.2 段落

段落实现其实比较简单,在一行/段结束后,回车换行,再回车添加一行空行,就可以新起一段了。或者,可以用<br>标签实现换行。

2.3 区块引用

其实上方的一些描述部分,已经使用了区块引用的标记。具体用法是:

在段落的每一行或第一行开头使用>符号,使用多个>可以实现嵌套引用。如:

> 区块引用
>> 嵌套引用

效果为:

区块引用

嵌套引用

2.4 代码区块

两种方式实现标记代码块:

  1. tab缩进
  2. '```'

2.4.1 tab缩进标记代码块

在代码段落前输入tab(或4个空格)缩进,即可使后面的代码呈现代码块的格式。如:

public static void Hello() {

System.out.println(“Hello MarkDown World!”);

}

效果为:

public static void Hello() {
    System.out.println(“Hello MarkDown World!”);
}

2.4.2 标记代码块

也可以在代码块的前后使用三个实现代码块的标记,效果同上。

CSDN博客上的MD编辑器的这种代码块标记支持代码语言的识别,和相应关键字的颜色变化

public static void Hello() {
        System.out.println(“Hello MarkDown World!”);
}

2.5 强调

MarkDown支持将文字内容加粗或斜体以强调内容,使用*_实现。如:

*斜体* 或 _斜体_
**粗体** 或 __粗体__

效果为:

斜体斜体
粗体粗体

2.6 列表

支持使用*-+标记无序列表,如:

-(或+*)第一项
-(或+*)第二项
-(或+*)第三项

效果为:

  • 第一项
  • 第二项
  • 第三项

将上述无序列表的标记替换为1.等数字+.的标签,即可标记有序列表(注意需要在换行后才可以实现有序列表的标记)如:

1. 第一项
2. 第二项
3. 第三项

效果为:

  1. 第一项
  2. 第二项
  3. 第三项

实验发现,在第一项标记为有序列表后,后续项只需添加无序列表标记(-+*)即可按序显示为有序标签

2.7 分割线

可以使用三个或以上*-, _添加分割线。如:

第一条分割线
***
第一条分割线

第一条分割线
___

效果为:

第一条分割线


第一条分割线


第一条分割线


2.8 链接

支持两种方式标记超链接

  1. 行内式
  2. 参考式

2.8.1 行内式

[Nian的CSDN博客](https://blog.csdn.net/NDK678)

效果为:

Nian的CSDN博客

2.8.2 参考式

[Nian的CSDN博客][1]
[Nian的CSDN博客2][2]
[1]:https://blog.csdn.net/NDK678
[2]:https://blog.csdn.net/NDK678

效果为:

Nian的CSDN博客1
Nian的CSDN博客2

注意:上方的[1]: https://blog.csdn.net/NDK678不会显示出来

2.9 图片

图片的添加实际上和上述超链接类似,使用图片的URL并在前面加一个![avater]![Alt text]标识符即可。
格式为:![avater/Alt text](图片链接 "title")

title可选不填
图片链接可以为本地图片路径也可以为网络图片URL

如:

![avater](https://wx4.sinaimg.cn/mw1024/4df12e06gy1ftu4jryufzj23402c0u0x.jpg “我的女神不许抢!”)

![Alt text](https://wx3.sinaimg.cn/mw1024/4df12e06gy1ftu4jpnko2j23sw2iox6p.jpg)

效果为:

我的第一篇MarkDown博文——MarkDown语法

我的第一篇MarkDown博文——MarkDown语法

2.10 反斜杠 \

反斜杠\实际功能就是反转义字符,可以将实现某些功能的标签字符反转义成其本来形式呈现。如:

\***
***

效果为:

***


2.11 符号‘`’

‘`’符号可以是被其括起来的字符在文字内容中呈被标识状态,上述的一些对特殊符号的引用、特殊格式的标记都用到了这一符号。如:

‘`’我的第一篇MarkDown博文’`’ (由于直接输入会被识别成标签,所以用单引号括了起来,实际应用中不需输入单引号)

效果为:

我的第一篇MarkDown博文

3.总结

这篇博文到此就就到了尾声了。第一次在CSDN发表自己的博文,第一次用MarkDown编辑文本,感觉很不错,虽然仍有很多需要改进的地方。本以为内容不是很多,但满打满算也耗费了一个下午,来系统的整理了这些MarkDown的基本语法,也算边写边练了一遍,收获颇丰。
希望今后撰写的速度能有所提升,也希望每一篇博文都是有一些价值的吧。
最后感谢Github上younghz/Markdown的总结,在本篇博文的撰写过程中提供了很大帮助。

2018年08月08日
北京尚水智淘

相关标签: MarkDown语法