不知道大家在逛github或者码云这些git管理工具或者项目中,时常发现会有一个文件readme.md文件。.md后缀的文件是markdown格式的文件,用这种格式的文件编写文档,不用我们关心排版问题。其实markdown的文档的排版用来写文档,其实已经算优美了,足够我们使用了。所以了解和学习markdown语法还是有必要的,花费不了我们多久的时间。简书上有人说是5分钟让你入门markdown,这个确实有点夸张了,针对没有html基础的人,我感觉1个小时能让你大部分学会markdown,有html基础的,30分钟吧。能够记得基本上常用的markdown语法了。
以下是markdown的比较简洁的教程地址: http://wowubuntu.com/markdown/#hr
这篇教程基本满足我们去使用markdown了。讲得比较好,也比较全面的让一个小白从零开始学习markdown语法。下面是我学习的简要的总结。其实markdown中直接使用html的基本元素是被允许的,除了一些特殊的标签,例如div,table,pre等标签,其它的标签在markdown展现的效果和原生的html标签效果是一样的。所以说只要你会html,markdown你都可以全部使用html标签来书写。总结了总共有10个左右的常用标签的书写方式
1. 标题:
# 等价于 <h1>
##<h2>
###<h3>
####<h4>
#####<h5>
例子 : # 标题内容(此时是一号标题) ## 标题内容(此时是二号标题)
2.粗体字 ** 内容**
**粗体**
3.斜体 * 内容 * 或者 _内容 _
_内容_
4.图片链接 ![](url) 或者 <img src="url"></img>
![]("http:/wwwwwwwww.ssjsj.sjsj/1.jpg")
直接使用html的 <img src="1.jpg"> 比较方便
5.普通链接 [链接名称](url) <a href="url">链接名称</a>
[百度]("http://www.baidu.com")
<a href="http://www.baidu.com">百度</a>
6.下划线 == ---
==============
------------------------
7.表格
| id | name | age |
|:---: | :---: | :-----:| // : ---- : 居中 :--- 居左 ----:居右
| 1 | 张三 | 李四 |
8.引用 >
> 泰戈尔的飞鸟集 -泰戈尔
9. 字符串 后面加2个空格 然后回车 等价于 <br/> (想要换行,可以这么做)
10. 代码段 ` 单代码段引用 ` ``` 多代码段引用 ```
` System.out.println("hello world"); `
```
System.out.println("hello world") ;
```
最后附上一个完整的包括上面内容的markdown的例子,找一下例如网页的有道比较,选择markdown文本格式,粘贴进去,
就可以预览效果和学习.
测试例子:
# 一号标题
## 二号标题
### 三号标题
**粗体字**
*斜体*
_斜体_
<img src="https://www.baidu.com/img/baidu_jgylogo3.gif" />
<a href="http://www.baidu.com"> **超链接**</a>
[**超链接**]("http://www.baidu.com")
#### 下划线
----
#### 表格
| id | name | age |
|:--:|:----:|:---:|
| 1 | 张三 | 20岁|
| 2 | 李四 | 30岁|
| 3 | 王麻子| 40岁|
#### 引用
> 你永远都不会叫醒一个装睡的人 -佚名
#### 单段代码生成
` echo "Hello Wolrd" `
#### 多段代码生成
```
var $name = "张三";
echo $name;
class Test
{
public static void main(String [] args)
{
System.out.prinln("Hello Wordl")
}
}