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

}

}