使用Github很久了、、自己也建过几个开源项目,但是对于README.md格式一直都是只用纯文本的,结果写出来的格式很乱也不美观、、
看别人写的都排版很好,也稍有郁闷,明明就是一纯文本而已的、、而事实上,也就是一个纯文本,只是用的Markdown格式说明而已(github据说好像对Markdown格式支持的也有扩展)。
下面就简单说下Markdown格式的简单排版的几个元素,让自己的README.md格式也美观起来、、网上别人亦说写作用Markdown格式也是不错的、、
大标题 =================================== 大标题一般显示工程名,类似html的<h1><br /> 你只要在标题下面跟上=====即可 中标题 ----------------------------------- 中标题一般显示重点项,类似html的<h2><br /> 你只要在标题下面输入------即可 ## 每级标题 用1~6个#加上空格代表没级标题 ,例如: # 一级标题 ## 二级标题 ### 三级标题 #### 四级表题 ##### 五级标题 ###### 六级标题 ### 注意!!!下面所有语法的提示我都先用3级小标题提醒了!!! ### 单行文本框 这是一个单行的文本框,只要两个Tab再输入文字即可 ### 多行文本框 这是一个有多行的文本框 你可以写入代码等,每行文字只要输入两个Tab再输入文字即可 这里你可以输入一段代码 ### 链接 [点击这里你可以链接到www.google.com](http://www.google.com)<br /> [点击这里我你可以链接到我的博客](http://www.dushibaiyu.com)<br /> ### 自动链接 只需要把网址或电子邮件用< >包含起来就行,例如: <br /> <http://www.dushibaiyu.com> <br/> <[email protected]> ### 只是显示图片 ![github](http://github.com/unicorn.png "github") ### 想点击某个图片进入一个网页,比如我想点击github的icorn然后再进入www.github.com [![image]](http://www.github.com/) [image]: http://github.com/github.png "github" ### 文字被些字符包围 > 文字被些字符包围 > > 只要再文字前面加上>空格即可 > > 如果你要换行的话,新起一行,输入>空格即可,后面不接文字 > 但> 只能放在行首才有效 ### 文字被些字符包围,多重包围 > 文字被些字符包围开始 > > > 只要再文字前面加上>空格即可 > > > > 如果你要换行的话,新起一行,输入>空格即可,后面不接文字 > > > > > 但> 只能放在行首才有效 ### 特殊字符处理 有一些特殊字符如<,#等,只要在特殊字符前面加上转义字符即可<br /> 你想换行的话其实可以直接用html标签<br /> ### 列表显示 * 用*,+,- 加空格即可 * 这是无序的列表 ### 有序列表 1. 直接数字加上英文的点,加空格即可 2. 这是第二个 ### 分割线 你可以在一行中用三個或以上的星号、减号、下划线來建立一個分割线,行內不能有其他東西。你也可以在星号中间插入空白。下面每种都可以建立分割线: * * * * *** ---- ____ - - - ### 强调 Markdown使用星号(*)和下划线(_)作为标记强调字词的符号相当与html的<em>,用两个*或_包起來的话,則相当与html的<strong>,例如: *强调* _强调_ **更加强调** __更加强调__ ### 代码高亮 用三个(`) 加上语言名字,然后换行输入代码,再代码结束时也用 三个(`)来结束,例如:<br /> ```C++ #include <iostream> int main () { std::cout << "Hello Word!" << std::endl; } ```
用的这个代码高亮插件居然没有Markdown类型,就退而求此用的html高亮了、、
对Markdown文件同样支持里面用html标记的。
上面这段的格式化显示在我的github上,传送门:https://github.com/dushibaiyu/DsbyLiteExample/blob/master/Markdown/study.md
还有参考的文档地址:http://markdown.tw/ 和 http://guoyunsky.iteye.com/blog/1781885
我咋看不懂尼
这个正常、、哈哈、、
这个java的吗?还是啥?
这是一个类似html的标记语言、、用于写些文章格式不错、、
哇
哇?
一直在找这个资料,谢谢
大神客气了、、
“简书”里面的排版貌似用的就是这个,还有为知笔记和印象都支持markdown,排版真是棒棒哒
恩,现在markdown很流行的、、