Markdown 基础语法
Markdown 是一种用来编写说明文档的语法,它易读易写,后缀名为‘md’。而且Markdown编写的文档,可以快速转化为PPT,World等产品文档。
Markdown的大部分标记符号都需要在其后面添加空格,否则会不生效,而且建议编写一段内容后,前后都有个换行符,保证可读性。
Markdown 标题
使用#
添加到你所需的文本前以创建一个文本的标题,不同数量的#
对应标题的级别。例子:
Markdown 段落
段落即一段文本,无需任何特殊标识符号,只需在段落前后添加空白行,Markdown即可正常转义为不同的段落。例子:
Markdown 换行
如果你的内容过长,可以通过在末尾添加两个或以上的空格,并且回车即可换行处理。直接在内容中回车是不会换行的)。例子:
Markdown 强调
强调分为两种 粗体 和 斜体
- 粗体在内容前后添加
两
个*
即可。例子:
- 斜体对在内容前后添加
一
个*
即可。例子:
Markdown 引用
在内容前使用>
即可创建内容的引用。例子
可以使用多个>
创建多个段落的引用。只需添加>
空白行即可。例子:
Markdown 列表
列表分为有序列表和无序列表两种形式
- 创建有序列表,需要在每个列表项前添加数字并且紧跟一个英文句号。数字的顺序可以随意。但是第一个数字必须为 1。并且使用缩进可以创建嵌套列表。例子:
- 创建无序列表,需要在每个列表项前添加
-
、*
或者+
。并且使用缩进也可以创建嵌套列表。例子:
Markdown 代码
使用`
添加在你的代码前后即可。例子:
如果你想在你的代码中使用 `
这个符号,不想让Markdown进行转义。使用两个反引号` `
添加到你的代码前后即可。例子:
Markdown 分隔线
创建分隔线 可以使用三个或以上的 ***
, ---
或者 ___
,并且不能包含其它内容,它们的渲染效果是一样的。为了兼容性,建议在分割线前后添加空白行
Markdown 链接
创建超链接需要满足以下形式: [超链接显示名](超链接地址 "超链接title")
对应的HTML代码为:
<a href="超链接地址" title="超链接title">超链接显示名</a>
例子:
URL和邮件链接可以直接在链接前后添加尖括号<>
即可。例子:
Markdown 图片
创建一个图片引用的语法和创建链接的语法相似:
区别在于前面加了感叹号。 对应的HTML代码为: <img src="图片链接" alt="图片alt" title="图片title">
例子:
Markdown 转义字符
如果想直接显示某些特殊字符比如:* >
不想经过Markdown 转义,那么在字符前添加\
即可。例子:
Markdown 内嵌HTML
Markdown里面可以直接写HTML标签的,如果Markdown的语法不能支持你想要的功能,直接写入标签代码即可,不用标识它是HTML还是Markdown,Markdown会自己进行解析判断。例子:
特别说明:行内标签和块级标签是有区别的:行内标签直接写入到内容中即可。但是块级标签使用时必须在前后添加空行,以便于与内容区分。而且在块级标签中的Markdown语法是不会生效的,只会被渲染为普通的内容。
总结
总的来说,Markdown的语法是简单且易学的,但是不同的Markdown应用程序所支持的功能是有区别的。具体的用法需要考虑具体的应用程序。