我的第一篇MarkDown博文——MarkDown语法
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 代码区块
两种方式实现标记代码块:
-
tab
缩进 '```'
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. 第三项
效果为:
- 第一项
- 第二项
- 第三项
实验发现,在第一项标记为有序列表后,后续项只需添加无序列表标记(-+*)即可按序显示为有序标签
2.7 分割线
可以使用三个或以上*
,-
, _
添加分割线。如:
第一条分割线
***
第一条分割线
—
第一条分割线
___
效果为:
第一条分割线
第一条分割线
第一条分割线
2.8 链接
支持两种方式标记超链接
- 行内式
- 参考式
2.8.1 行内式
[Nian的CSDN博客](https://blog.csdn.net/NDK678)
效果为:
2.8.2 参考式
[Nian的CSDN博客][1]
[Nian的CSDN博客2][2]
[1]:https://blog.csdn.net/NDK678
[2]:https://blog.csdn.net/NDK678
效果为:
注意:上方的[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)
效果为:
或
2.10 反斜杠 \
反斜杠\
实际功能就是反转义字符,可以将实现某些功能的标签字符反转义成其本来形式呈现。如:
\***
***
效果为:
***
2.11 符号‘`’
‘`’符号可以是被其括起来的字符在文字内容中呈被标识状态,上述的一些对特殊符号的引用、特殊格式的标记都用到了这一符号。如:
‘`’我的第一篇MarkDown博文’`’ (由于直接输入会被识别成标签,所以用单引号括了起来,实际应用中不需输入单引号)
效果为:
我的第一篇MarkDown博文
3.总结
这篇博文到此就就到了尾声了。第一次在CSDN发表自己的博文,第一次用MarkDown编辑文本,感觉很不错,虽然仍有很多需要改进的地方。本以为内容不是很多,但满打满算也耗费了一个下午,来系统的整理了这些MarkDown的基本语法,也算边写边练了一遍,收获颇丰。
希望今后撰写的速度能有所提升,也希望每一篇博文都是有一些价值的吧。
最后感谢Github上younghz/Markdown的总结,在本篇博文的撰写过程中提供了很大帮助。
2018年08月08日
北京尚水智淘