markdown的简单入门和学习

原文: https://blog.csdn.net/xyz_dream/article/details/79062390

不知道大家在逛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.图片链接
或者 <img src=”url”></img>




直接使用html的 <img src=”1.jpg”> 比较方便


5.普通链接 链接名称 <a href=”url”>链接名称</a>


百度


<a href=”http://www.baidu.com">百度</a>


6.下划线
== —


==============


————————



7.表格


| id | name | age |


|:—: | :—: | :—–:| // : —- : 居中 :— 居左 —-:居右


| 1 | 张三 | 李四 |


8.引用
>


> 泰戈尔的飞鸟集 -泰戈尔


9.
字符串 后面加2个空格 然后回车 等价于 <br/> (想要换行,可以这么做)


10.
代码段
</span><span class="ql-author-7848182" style="font-size:14px;font-weight:bold;">单代码段引用 </span><span class="ql-author-7848182" style="font-size:14px;font-weight:bold;">
</span><span class="ql-author-7848182" style="font-size:14px;font-weight:bold;">多代码段引用 </span><span class="ql-author-7848182" style="font-size:14px;font-weight:bold;">




System.out.println("hello world");


</span></p> <p class="ql-long-7848182"><span class="ql-author-7848182"><span/>System.out.println("hello world") ;</span></p> <p class="ql-long-7848182"><span class="ql-author-7848182" style="font-weight:bold;"><span/>


最后附上一个完整的包括上面内容的markdown的例子,找一下例如网页的有道比较,选择markdown文本格式,粘贴进去,


就可以预览效果和学习.



测试例子:




# 一号标题


## 二号标题


### 三号标题




粗体字


斜体


斜体_




<img src=”https://www.baidu.com/img/baidu_jgylogo3.gif" />



<a href=”http://www.baidu.com"> 超链接</a>


超链接




#### 下划线


—-




#### 表格




| 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”)


}


}