作为一款「写作软件」在诞生之初就支持了 Markdown,Markdown 是一种「电子邮件」风格的「标记语言」,我们强烈推荐所有写作者学习和掌握该语言。为什么?可以参考:
『为什么作家应该用 Markdown 保存自己的文稿』。
『Markdown写作浅谈』
在此,我们总结 Markdown 的优点如下:
纯文本,所以兼容性极强,可以用所有文本编辑器打开。
让你专注于文字而不是排版。
格式转换方便,Markdown 的文本你可以轻松转换为 html、电子书等。
Markdown 的标记语法有极好的可读性。
当然,我们既然如此推崇 Markdown ,也必定会教会你使用 Markdown ,这也是本文的目的所在。不过,虽然 Markdown 的语法已经足够简单,但是现有的 Markdown 语法说明更多的是写给 web 从业者看的,对于很多写作者来说,学习起来效率很低,现在,我们特地为写作者量身定做本指南,从写作者的实际需求出发,介绍写作者真正实用的常用格式,深入浅出、图文并茂地让您迅速掌握 Markdown 语法。
为了使您更好地学习,我们建议您登录「简书」,将您的编辑器切换至 Markdown 编辑器,新建一篇空白笔记,然后点击右上角的预览模式,此时,您的界面应当如下图所示,左侧为编辑区域,右侧为预览区域,您在左侧输入 Markdown 语法的文本,右侧会立即帮您呈现最终结果,好了,让我们开始学习吧~
简书的预览模式可以帮助你更快掌握 Markdown:
标题
这是最为常用的格式,在平时常用的的文本编辑器中大多是这样实现的:输入文本、选中文本、设置标题格式。
而在 Markdown 中,你只需要在文本前面加上 # 即可,同理、你还可以增加二级标题、三级标题、四级标题、五级标题和六级标题,总共六级,只需要增加 # 即可,标题字号相应降低。例如:
# 一级标题 ## 二级标题 ### 三级标题 #### 四级标题 ##### 五级标题 ###### 六级标题
注:# 和「一级标题」之间建议保留一个字符的空格,这是最标准的 Markdown 写法。
你可以你的编辑器中尝试输入这六级标题,可以参考下方的截图:
列表
列表格式也很常用,在 Markdown 中,你只需要在文字前面加上 - 就可以了,例如:
- 文本1 - 文本2 - 文本3
如果你希望有序列表,也可以在文字前面加上 1. 2. 3. 就可以了,例如:
1. 文本1 2. 文本2 3. 文本3
1. 文本12. 文本23. 文本3
注:-、1.和文本之间要保留一个字符的空格。
列表案例截图如下:
链接和图片
在 Markdown 中,插入链接不需要其他按钮,你只需要使用 [显示文本](链接地址) 这样的语法即可,例如:
[简书](http://jianshu.io)
在 Markdown 中,插入图片不需要其他按钮,你只需要使用 ![](图片链接地址) 这样的语法即可,例如:
![](http://ww4.sinaimg.cn/bmiddle/aa397b7fjw1dzplsgpdw5j.jpg)
注:插入图片的语法和链接的语法很像,只是前面多了一个 !。
插入链接和图片的案例截图:
引用
在我们写作的时候经常需要引用他人的文字,这个时候引用这个格式就很有必要了,在 Markdown 中,你只需要在你希望引用的文字前面加上 > 就好了,例如:
> 一盏灯, 一片昏黄; 一简书, 一杯淡茶。 守着那一份淡定, 品读属于自己的寂寞。 保持淡定, 才能欣赏到最美丽的风景! 保持淡定, 人生从此不再寂寞。
注:> 和文本之间要保留一个字符的空格。
最终显示的就是:
一盏灯, 一片昏黄; 一简书, 一杯淡茶。 守着那一份淡定, 品读属于自己的寂寞。 保持淡定, 才能欣赏到最美丽的风景! 保持淡定, 人生从此不再寂寞。
引用的案例截图:
粗体和斜体
Markdown 的粗体和斜体也非常简单,用两个 * 包含一段文本就是粗体的语法,用一个 * 包含一段文本就是斜体的语法。例如:
*一盏灯*, 一片昏黄;**一简书**, 一杯淡茶。 守着那一份淡定, 品读属于自己的寂寞。 保持淡定, 才能欣赏到最美丽的风景! 保持淡定, 人生从此不再寂寞。
最终显示的就是下文,其中「一盏灯」是斜体,「一简书」是粗体:
一盏灯, 一片昏黄;一简书, 一杯淡茶。 守着那一份淡定, 品读属于自己的寂寞。 保持淡定, 才能欣赏到最美丽的风景! 保持淡定, 人生从此不再寂寞。
粗体和斜体的案例截图:
表格
相关代码:
| Tables | Are | Cool | | ------------- |:-------------:| -----:| | col 3 is | right-aligned | $1600 | | col 2 is | centered | $12 | | zebra stripes | are neat | $1 |
显示效果:
Tables | Are | Cool |
---|---|---|
col 3 is | right-aligned | $1600 |
col 2 is | centered | $12 |
zebra stripes | are neat | $1 |
相关代码:
dog | bird | cat ----|------|---- foo | foo | foo bar | bar | bar baz | baz | baz
显示效果:
dog | bird | cat |
---|---|---|
foo | foo | foo |
bar | bar | bar |
baz | baz | baz |
显示链接中带括号的图片
代码如下:
![][1] [1]: http://latex.codecogs.com/gif.latex?\prod%20\(n_{i}\)+1
结语
以上几种格式是比较常用的格式,所以我们针对这些语法做了比较详细的说明。除这些之外,Markdown 还有其他语法,如想了解和学习更多,可以参考这篇『Markdown 语法说明』。
强烈建议您现在就立马用 Markdown 写一篇文章吧,体会一下 Markdown 的优雅之处!
最后,希望我们的指南可以帮助到您,也希望「简书」能够成为您书写 Markdown 的最佳选择。
作者 Coreseek 主要开发人员: nzinfo,<li.monan(at)gmail.com>, HonestQiao,<honestqiao(at)gmail.com> Sphinx 的最初作者和目前的主要开发人员: Andrew Aksyonoff,<shodan(at)shodan.ru> 贡献者 为Sphinx的开发出过力的人员和他们的贡献如下(以下排名不分先后): Robert "
作者: Loic Dachary 作者: Nathan Cutler 许可证: Creative Commons Attribution-ShareAlike (CC BY-SA) Note 旧的 (pre-2016) 开发者文档已经挪到了 内部开发者文档 。 简介 This guide has two aims. First, it should lower the barrier to ent
官网英文原文地址:http://dev.px4.io/starting-contributing.html 核心开发团队和社区的联系信息可以在下面找到。PX4项目使用了三个分支Git branching model: master 默认情况下不稳定,可以看到快速的开发。 beta 已充分测试,面向飞行测试者。 stable 指向最新的发布分支。 我们尝试通过rebases保持一个线性的历史,避免G
Sphinx 默认是使用reStructuredText(简称reST) 格式进行写作,喜欢Markdown格式可以使用Recommonmark插件来实现。 大部分情况,我们写普通的Markdown格式,如果需需要高级一些的用法,可以看看下面有没有想要的效果: Markdown转reST 重要 Its a note! in markdown! 注解 Its a note! in markdown!
概述 微哨开放平台,是微哨基于高校现状,为合作高校提供的系统快速对接、内容运营管理、应用简单移植等一系列解决方案的统一、专业、开放平台。 微哨提供功能强大的各种接口,合作高校可以快速、简单的与微哨对接,使用微哨给指定部门、指定身份、指定时间发送通知(如汉语言文学院的内部通知),还可以通过应用提醒接口,给某一些用户群发送指定内容。 基本流程 登录或注册微哨开发者账号 完善开发者信息 点击右上角的邮箱
新手指南提供了 MIP 的一些技术指引,主要是后文的总体预览,详细内容可点击相关链接进行查看。 第一次使用 MIP 本教程对初学者十分友好,点击下面的链接可以进行第一次 MIP 页面的开发与调试体验,还可以了解 MIP 在搜索中是如何生效的。 创建第一个 MIP 页面 调试与验证 MIP 页面 MIP 搜索生效 如何从 MIP 1.0 迁移到 2.0 相较于 MIP 1.0,MIP 2.0 版本提