本文是学习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个
li
- 我是有序列表第2个
li
- 我是有序列表第3个
li
##长的有序列表测试##
- 工作中碰到的困难只是暂时的,不管是怎样的困难,
- 项目开始前,必须对项目的架构做可行性、
- 不要停下你学习脚步,不管你在现在在做的项目中有没有碰到困难,都要及时地给自己充电,拓宽自己的知识面和提高自己的技能
字符*、+、-
生成无序列表
- 我是无序列表第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个空格
连接- 标题层级如下,最多6级
1 | # 顶级标题 等价于 title 和 <h1> |
加强和强调规范
以下两种写法都是正确的,请统一为第一种,即一律使用 **加强
*强调
1 | *emphasize* **strong** 相当于<strong>标签和<em>标签 |
代码块规范
- 行内代码使用
1对波浪号
如: `hello world!` - 块级代码使用
3个波浪号
或整体4空格缩进
,且上下均用整行隔开
,如下: (占用7行)
1 | <?php |
<?php
echo '看我源码 - 4空格缩进';
?>
列表写法
- 列号
1.
或者*
后其后内容空格
隔开 - 列表块前后
整行隔开
如下:
1 | 1. Windows |
实际预览:
- Windows
- Mac
- iOS
- iPhone
- iPad
- Android
1 | * Windows |
实际预览:
- Windows
- Mac
- iOS
- Android
- v3.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 | # Hello-World |
注:引用范例请参看源码底部
License
Released under MIT LICENSE