Markdown是一种极简的『标记语言』,将文本转为HTML,通常为我大码农所用。其不追求大而全,简洁至上,正所谓不求最贵,只求最好!
本文介绍Markdown基本语法,内容很少,一行语法一行示例,学会后可轻松写出高大上的文档,再也不需要各种编辑器去调文章格式。另外,网上有各平台下的Markdown工具可用,也有在线的,我直接使用sublime搞定,Markdown本来就是为了追求简洁,弄个工具岂不多此一举。
强调
星号与下划线都可以,单是斜体,双是粗体,符号可跨行,符号可加空格
1 | **粗体** |
粗体
粗体
斜体
_斜体_
分割线
三个或更多-_*,必须单独一行,可含空格
---
引用
翻译成html就是<blockquote></blockquote>符号后的空格可不要
> 引用
引用
1 | 内层符号前的空格必须要 |
引用
引用中的引用
标题:Setext方式
1 | 三个或更多 |
大标题
小标题
标题:Atx方式
1 | # 一级标题 |
一级标题
二级标题
三级标题
四级标题
五级标题
六级标题
无序列表
1 | 符号之后的空格不能少,-+*效果一样,但不能混合使用,因混合是嵌套列表,内容可超长 |
- 无序列表
- 无序列表
- 无序列表
1 | 符号之后的空格不能少,-+*效果一样,但不能混合使用,因混合是嵌套列表 |
- 无序列表
- 无序列表
- 无序列表
1 | 符号之后的空格不能少,-+*效果一样,但不能混合使用,因混合是嵌套列表 |
- 无序列表
- 无序列表
- 无序列表
1 | 数字不能省略但可无序,点号之后的空格不能少 |
- 有序列表
- 有序列表
- 有序列表
- 有序列表
1 | -+*可循环使用,但符号之后的空格不能少,符号之前的空格也不能少 |
- 嵌套列表
- 嵌套列表
- 嵌套列表
- 嵌套列表
- 嵌套列表
- 嵌套列表
文字超链:Inline方式
1 | Tooltips可省略 |
图片超链
1 | 多个感叹号,Tooltips可省略,要设置大小只能借助HTML标记 |
索引超链:Reference方式
1 | 索引,1 2可以是任意字符 |
[Ocean’s Blog][1]
![GitHub Octocat][2]
[1]:https://oceandlnu.github.io/
[2]:http://github.global.ssl.fastly.net/images/modules/logos_page/Octocat.png
自动链接
1 | 尖括号 |
代码:行内代码
1 | 每行文字前加4个空格或者1个Tab |
val s = "hello Markdown"
代码:段落代码
1 | 内容包含在```bash和```之间,bash换成指定编程语言,也可以省略 |
代码:hexo
1 | 可指定编程语言,代表左右大括号 |
注释1
<!-- 注释 -->
用html的注释,好像只有这样?
转义字符
1 | Markdown中的转义字符为\,转义的有: |
文本中可直接用html标签,但是要前后加上空行。
表格
目前编辑器不支持表格,以往是通过截图,呈现的效果并不好,Markdown支持html,所以我们可以用html来写表格。但是……用html写表格,实在太麻烦了,这里有个简单的转换方法,供大家参考:
举例,假设有这样一个表格,内容如下:
时间 地点 人物
3月5日 北京 姚明
3月7日 上海 韩寒
处理方法如下:
1.从word或excel中复制表格
2.打开此链接
3.贴上复制的文字,然后按convert,就会得到这个表格的代码
4.简要说明表格设定如下:
1 | 将第一个 <table>变成<table class="table table-bordered table-striped table-condensed">。 |
如果要调整整个表格的宽度,可以参考berlinix的这篇文章:http://www.ituring.com.cn/article/details/8367
5.把最后得到的代码复制到文中,下面就是结果啦:
时间 地点 人物 |
3月5日 北京 姚明 |
3月7日 上海 韩寒 |
如果大家对此感兴趣,这里有一个进阶资料:http://twitter.github.com/bootstrap/base-css.html#tables
结束语
以上基本够用,更详尽的请参考文献10,另外Markdown+R可以干大事,请参考文献6。
参考文献
1.献给写作者的 Markdown 新手指南
2.Cmd Markdown 编辑阅读器
3.Markdown之表格的处理
4.Markdown语法说明(详解版)
5.怎样使用Markdown
6.Markdown写作浅谈
7.Markdown语法示例
8.HTML转义字符对照表
9.Markdown: Basics (快速入门)
10.Markdown 语法说明 (简体中文版)