Markdown 学习笔记·入门
花一点点时间了解了下Markdown的语法,确实非常简单,这里做下总结,也算是对Markdown语法的熟悉,及模仿造轮子吧~
markdown 简介
Markdown是一种可以使用普通文本编辑器编写的标记语言,通过简单的标记语法,它可以使普通文本内容具有一定的格式。
Markdown具有一系列衍生版本,用于扩展Markdown的功能(如表格、脚注、内嵌HTML等等),这些功能原初的Markdown尚不具备,它们能让Markdown转换成更多的格式,例如LaTeX,Docbook。Markdown增强版中比较有名的有Markdown Extra、MultiMarkdown、 Maruku等。这些衍生版本要么基于工具,如Pandoc;要么基于网站,如GitHub和Wikipedia,在语法上基本兼容,但在一些语法和渲染效果上有改动。--百度百科
特点总结
- 纯文本,所以兼容性极强,可以用所有文本编辑器打开。
- 让你专注于文字而不是排版。
- 格式转换方便,Markdown 的文本你可以轻松转换为 html、电子书等。
- Markdown 的标记语法有极好的可读性。
Markdown 语法介绍
基本符号
- *,-,+ 3个符号 被称为Markdown符号
- 空白行表示另起一个段落
- `是表示inline代码,tab是用来标记 代码段,分别对应html的code,pre标签
标题
-
#
+ 空格 后面的文字即表示为标题# 表示一级标题,## 表示二级标题,依次表示 1-6 级标题
注意: 符号后面要加一个 空格 和文本内容隔开
-
还可以在文字下行加= 表示大标题 - 表示小标题 慎用吧
例如: 大标题 = 小标题 -
字体:斜体 / 加粗
*文本* 表示文本内容为斜体, **文本** 表示文本内容为斜体
- 效果: 斜体文本 加粗文本
换行
- 段落间加一个 空白行 分割 同html中的
<p>
- 连续两个空格即为换行 同html中的
<br>
列表
使用*,+,-加上一个空格来表示
-
可以支持嵌套,如
*,+,-效果一样的 - 外层列表项目 + 内层列表项目 + 内层无序列表项目 + 内层列表项目 - 外层列表项目
效果
- 外层列表项目
- 内层列表项目
- 内层列表项目
- 内层列表项目
- 外层列表项目
-
有序列表用 数字+英文点+空格来表示
- 1. 这样会展示序号
效果:
- 这样会展示序号
注意:列表内容很长的,不需要手工输入换行符,css控制段落的宽度,会自动的缩放的
链接
-
这其实是我第一个接触的markdown语法,第一篇资料收集时就用到了
直接使用 [文本](链接)
-
效果:百度
如果很多地方需要相同的url呢,可以预先定义url 这样玩:[ref_name]:URL ref_name 一般使用数字表示,显得专业 然后在需要使用链接的地方 使用[文本][ref_name] 这种方式即可,酷炫
-
效果
[1]:https://www.baidu.com/[ref_name]:url 如: [1]:https://www.baidu.com/
引用上面定义的url [百度][1]
-
如果想把URL展示出来,并可以作为链接使用 这样玩:
<URL>
<url> 如: <https://www.baidu.com/>
图片
-
图片语法与链接类似
![](图片地址) 如: ![](http://i.imgur.com/P7ACmyM.png)
-
同样可以使用引用的方式使用图片
这样定义:[id]:图片url 这样引用定义 ![][id]
定义图片的大小或比例
-
方法一:嵌入HTML代码
<img src="./xxx.png" width = "300" height = "200" alt="图片名称" align=center /> 注意:要居中展示,外围加<div>即可
-
方法二:使用支持图片大小更改操作的 Mou 编辑器 (mac可以玩)
![](url =100x100) 注意: =前有个空格,可以只写宽度。
方法三: 阿里云的OSS,七牛云的图片服务器时,url上加上相关操字段即可实现图片大小,比例修改,具体见各自的产品文档~
引用
- 开篇关于Markdown的简介和特点就是引用的百度, 只要在第一行加上 “>”和一个空格,表示代码引用,还可以嵌套
转义
-
使用 \ 来转义,表示文本中的markdown符号
如: \[百度](https://www.baidu.com/)
效果:[百度](https://www.baidu.com/)
表格
- 表格代码
| Tables | Are | Cool |
| ------------- |:-------------:| -----:|
| col 3 is | right-aligned | $1600 |
| col 2 is | centered | $12 |
| zebra stripes | are neat | $1 |
------------- 左对齐 :-------------: 居中 -----:右对齐
- 效果:
Tables | Are | Cool |
---|---|---|
col 3 is | right-aligned | $1600 |
col 2 is | centered | $12 |
zebra stripes | are neat | $1 |
代码块
- 按下Tab键 或4个空格即表示代码块
C#:
//这里显示一些代码,在正文显示中会自动识别语言,进行代码染色,这是一段C#代码
public class Blog
{
public int Id { get; set; }
public string Subject { get; set; }
}
这样基本就可以玩起来了,还是需要多实践,多谢,多总结。
我们活在各自的的心灵世界,我们有什么样的心,就决定我们看到什么样的世界