mardowm语法简单测试

本文是学习markdown语法做的一些简单测试。引用MarkDown 团队统一书写规范 v1.0

一个回车或者大于等于2个空格是一个段落。

1个#号可以生成h1

2个#号可以生成h2

3个#号可以生成h3

下面以此类推到h6

一个Tab可以生成code BlockS

<html>
<head>
    <style>
        .clas{ font-size:12px;}
    </style>
</head>
<body>
    <div class="page">
    </div>
</body>
</html>

在一个段落前面加>可以生成一个 blockquotes

我是用>生成的blockquote

数字1. 2.生成有序列表

  1. 我是有序列表第1个li
  2. 我是有序列表第2个li
  3. 我是有序列表第3个li

##长的有序列表测试##

  1. 工作中碰到的困难只是暂时的,不管是怎样的困难,
  2. 项目开始前,必须对项目的架构做可行性、
  3. 不要停下你学习脚步,不管你在现在在做的项目中有没有碰到困难,都要及时地给自己充电,拓宽自己的知识面和提高自己的技能

字符*、+、-生成无序列表

  • 我是无序列表第1个li
  • 我是无序列表第2个li
  • 我是无序列表第3个li

PS:每个列表的末尾需要4个空格或者tab

链接和图片生成的方法

[链接名称](链接)
![图片名称](链接)

链接测试

测试图片

我是codecode,我是加粗,我是斜体,我是删除

***可以生成hr


单纯的链接根式<链接>
http://huixisheng.github.com/

特殊的字符需要转义, _ *




引用开始

MarkDown 团队统一书写规范 v1.0

由于 MarkDown 语法在细节的书写方式很多,为了让不同个体的文档传产出结构一致,提炼出此规范。
该规范遵循 MarkDown 官方语法 以及 GitHub MakDown 语法,旨在统一书写格式和代码风格,将多种写法统一。

注:本文档符合自身规范,可视作demo,参看源码

大家可以 fork 后形成自己团队的规范版本

1.1全局规范

  • MarkDown 文件均使用.md作为后缀 (小写字母)
  • 普通文本换行,使用行末尾2空格触发

格式规范

标题结构格式

  1. 标题与紧贴的上下正文使用1整行换行隔开
  2. #号和文字之间1个空格连接
  3. 标题层级如下,最多6级
1
2
3
4
5
6
7
# 顶级标题 等价于 title 和 <h1>
## 次级标题 等价于 <h2>
### 3级标题 等价于 <h3>
#### 4级标题 等价于 <h4>
##### 5级标题 等价于 <h5>
###### 6级标题 等价于 <h6>
####### 注:此行错误,标题层级最多6级 没有<h7>标签

加强和强调规范

以下两种写法都是正确的,请统一为第一种,即一律使用 **加强 *强调

1
2
*emphasize*   **strong** 相当于<strong>标签和<em>标签
_emphasize_ __strong__

代码块规范

  • 行内代码使用1对波浪号 如: `hello world!`
  • 块级代码使用3个波浪号整体4空格缩进,且上下均用整行隔开,如下: (占用7行)
1
2
3
<?php
echo '看我源码 - 3个波浪号';
?>
<?php
    echo '看我源码 - 4空格缩进';
?>

列表写法

  • 列号1. 或者*后其后内容空格隔开
  • 列表块前后整行隔开 如下:
1
2
3
4
5
6
1. Windows
2. Mac
3. iOS
* iPhone
* iPad
4. Android

实际预览:

  1. Windows
  2. Mac
  3. iOS
    • iPhone
    • iPad
  4. Android
1
2
3
4
5
6
* Windows
* Mac
* iOS
* Android
1. v3.2
2. v4.1

实际预览:

  • Windows
  • Mac
  • iOS
  • Android
    1. v3.2
    2. v4.1

其他标签规范

链接和Email
Inline:

1
An [example](http://url.com/ "Title")

引用样式标签 (titles are optional):

An [example][id]. Then, anywhere
else in the doc, define the link:

[id]: http://example.com/  "Title"

Email:

1
An email <example@example.com> link.

插图
Inline (titles are optional):

1
![alt text](/path/img.jpg "Title")

引用式插图:

![alt text][id]

[id]: /url/to/img.jpg "Title"

引用块及嵌套

Email-style angle brackets
are used for blockquotes.

And, they can be nested.

Headers in blockquotes

  • You can quote a list.
  • Etc.

内联代码

<code> 段落中的用法

也可以 `代码中包含波浪号`.
代码块

Indent every line of a code block by at least 4 spaces or 1 tab.
代码的每行都最少用4个空格或者一个制表符(tab)

我是普通文本块

我是一个预格式化的
代码块.

水平分割线
三个连字符-:


表格规范

一个简单的表格看起来如下:

第一个头部 第二个头部 第三个头部
内容格子 内容格子 内容格子
内容格子 内容格子 内容格子

每列的对齐可以通过在分割线上添加冒号来实现:

第一个头部 第二个头部 第三个头部
左对齐 居中 右对齐
左对齐 居中 右对齐

页内锚标记


附:参考 Hello-World.md 源码,注意换行的使用

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
# Hello-World

这是一个范例文件格式
我是普通换行

## 我是<h2>标题

我是`<h2>`的内容

## 我是<h3>标题

* Windows
* Mac
* iOS
* Android

注:引用范例请参看源码底部

License

Released under MIT LICENSE

引用结束


参考

  1. MarkDown 团队统一书写规范 v1.0
  2. http://xianbai.me/learn-md/article/extension/table.html