Markdown傻瓜教程

2014-03-12 10:22:47

这篇介绍主要是想让不懂技术的人能快速掌握Markdown。

阅读时最好边看边把示例贴到可以预览的地方随时预览并编辑。可以使用马克飞象进行预览编辑,在最后也列出了一系列可在线编辑Markdown的网站。

使用Markdown的好处

  • 语法简单,易写易读。
  • 摆脱大型软件工具的束缚,写作不再需要Word。
  • 提高效率。熟练后可比用Word写字要快。
  • 保存格式自由,不需要特定软件就可以编辑。
  • 不少流行服务提供了对Markdown的支持,比如Trello。

Markdown的基本格式

标题

文字前加#号代表后面的文字的字号会变大,显示为标题,#号数量越多,代表字号越小,标题层级越低,而单独一个#就是最高一级的标题,如:

  • # 标题 1
  • ## 标题 2
  • ### 标题 3

特别注意#号和文字之间一定要有一个空格。

段落

当你写完一段文字,如何开始下一段呢?仅仅回车换行一次是不管用的,需要多一次回车,总共两次回车换行才行,也就是说需要空出一行来。

因为Markdown中用一个或一个以上的空行来分割段落,这里的空行是指真的空出了一行,就是写完一段后需要两次回车。比如:

Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.
(空行)
Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat.

列表

只需要在列表的每一项前面加*号,*号和文字之间注意要留空格:

做西红柿炒鸡蛋需要的原料:
* 西红柿   
* 鸡蛋    
* 盐 
* ...

如果想要有数字序号的列表呢,只要把*改成相应的1.2.等就好了,注意数字后面要有.

西红柿炒鸡蛋的做法:
1. 西红柿洗净切块
2. 鸡蛋打入碗内
3. 热锅热油倒入打好的蛋液翻炒
4. ...

引用

有时想要引用别人的一段话,只要在引用的文字前加>,连续多行添加>了的文字,将变成一个引用的区块。比如这样写:

Albert Einstein:
> A person who never made a mistake never tried anything new.
> Everything should be made as simple as possible, but not simpler.

特别注意>号与文字之间也要留空格。

链接

想要这种显示成文字的链接吗?: 豆瓣

简单,只要这样写:前面[]里是要显示出来的文字,而紧接着的()里是点击后要转到的链接的网址:

[豆瓣](http://www.douban.com/)

图片

写法很像链接,只是前面添加了一个惊叹号!

[]里是图片的描述(图片替代文字),而紧接着的()里是图片的网址:

![一张熊猫的图片](http://news.xinhuanet.com/tw/2008-03/25/xin_412030525160179626381.jpg)

预览

预览工具或软件

Q&A

如何打开和保存以Markdown写的文件?

因为就是纯文本,可以用任意文本编辑软件直接打开和保存。Windows下可以直接用记事本,也可以将文本复制出来贴到在线预览工具里。

文件后缀习惯上可以是.md.markdown,也可以直接.txt

小任务

为了练习和检验Markdown的学习效果,这里有一段文字,可以按照要求试一下:

  1. 将这段文字分为三段显示;
  2. 将其中的“豆瓣”都变成可点击的链接;
  3. 将“书籍,电影,音乐”三项写成列表格式;
  4. 将阿北说的话写成引用文字格式。

以下是这段练习文字:


豆瓣是一个中国大陆的社区网站。

豆瓣由阿北创立于2005年3月6日。该网站以书影音起家,提供了关于

  • 书籍
  • 电影
  • 音乐

等作品的信息,无论描述还是评论都由用户提供,是中国Web2.0网站中具有特色的一个网站。

阿北说:

第一年的时候有的叫我们是一个书评网站,有人说我们是一个电子商务网站,到07年的时候很多人说我们是一个社交网站。 具体是什么?其实我们从来不太问自己这个问题,我们觉得我们做的东西有用,用户能用起来就好。


你是谁

2013-06-16 16:32:53

一只熊猫 走呀走 迷了路 掉眼泪

还好呀碰到一个同路的陪

熊猫问他你是谁 他说不用问我是谁 能一起走一程就很美

两个朋友 一起走 春到夏 秋又冬

慢慢地 就能发现对方的痛

熊猫想想没关系 也许这就是同行人 能互相搭个伴就很美

有开心 有争吵 却始终不愿分开

渐渐地 熊猫也 再不想问他是谁

到达的 那一天 面前是一片竹的海

傻瓜呀 我当然 也是 一只熊猫诶


新完成的一首歌,词是一个朋友写的,很好玩很特别,去我的音乐人小站听歌~

一场落荒而逃的音乐会

2013-05-21 21:35:17

那么多年已过去

我依旧还是会想起你的脸

你那年说了什么

这一点已经是不那么重要

一场落荒而逃的音乐会

我们走在那北京的夜

就算北风吹起 你的脚步轻盈

重要的只是 我们曾经相遇


新写的一首歌,去听听吧~

与GitHub工程师的简短交流

2013-05-09 18:19:15

 2013年4月24日晚上,托QCon的福在贝塔咖啡有幸见到了GitHub的两位工程师,Ted Nyman(@tnm)和Jesse Newland(@jnewland)。在这期间我零散地问了两位工程师几个问题,准备的不充分,没问太具体的语言编码问题,随机的问了点儿感兴趣的问题。

对于过大pull request如何更好处理

因为项目进行中经常出现功能独立,且包含代码非常多的情况,这时提交的pull request,代码审查很不好做,因为代码非常多,看不过来。我见过最大的近千个commits,上百diffs的pull request。 Jesse的建议是应该优化流程,拆解成小的任务分别提交最终合并成一个大merge来提交。 看起来就是这种司令官与副官工作流

关于提交pull request的最佳时机,是早提交还是完全写好再提交呢?

Ted说这个应该看情况而定,如果不太有把握的修改就尽早提交,甚至可能只改了一行就提交,这样可以尽早获得其他同事帮助。

在GitHub工作是如何分工的

Ted说很多人远程工作,基本按各自的兴趣分功能来做。 Ted自己没有特别固定的工作时间,虽然他就住在SF,但每周只去公司三天,其他时间在家办公,他喜欢深夜工作,会工作到凌晨三四点,这时效率比较高,同时也有协作时差的问题,因为同事在世界各地,就有时差问题。 GitHub有一百多员工,.com部分--他们管website的部分就叫.com项目--有二十多人在做。

GitHub使用什么项目管理工具

GitHub Issue,只用这个。

GitHub内部专用的手机应用

  • 一个是工作用的交流工具,因为GitHub的百余位工程师遍布全球,所以沟通工具对他们来说特别重要。他们对37Signals的Campfire进行了的封装定制,同时做了增强,具有直接输入/deploy来进行部署等很酷功能。他们的使用很重,占用了Campfire全部流量的十分之一,另外还提到他们和37Signals的关系不错,会给37提供建议和帮助。
  • 另一个是twitter类似的应用,非工作用交流,发广播po照片什么的,在这篇12年的采访中也有提到。

GitHub的设计师使用版本控制吗?

Jesse说在GitHub,设计师也使用版本控制,他认为设计和编码的界限是模糊的。 不提交大文件,比如PSD,不要提交到代码仓库,而是将最终的图片文件提交,GitHub有很好的图片对比功能供用户使用。

其他八卦

  • 我称赞了他们在GitHub flavored Markdown上的工作,Ted说他们做了非常多工作在文字处理上面。还提到了一点前端的细节,比如在鼠标点击评论框时才会加载可以触发mentions和Emoji的控件,这样效率最佳。
  • 在交流时他们使用Emoji非常多,比如在一些比较过于严肃,或者气氛紧张的情况下用一些表情的话会非常有好处,
  • 他们在做website上的Ctags哦。



Day One

2013-04-16 10:49:13



基本已经用这个软件替换掉了Evernote,使用三周时间记录了110条日记。

Evernote是我用来记录日常信息碎片的,然后用tag和搜索日后找信息。不得不说Evernote还是有很强的点,比如图片OCR文字搜索,不过虽然很强,但对我来说没用。前一阵子的安全事件和笨重的界面让我开始寻找替代品。4月11日Day One的Mac版升级到1.7.3,加上了添加tag功能(iOS之前已经有了这功能),这时对我来说已经可以完全替换过来了。

使用Day One比较晚,当时是在Twitter上发现官方整理的一篇很诱人的文章Uses,里面介绍了Day One的多种用法,就被诱惑了。估计这也他们新增了不少用户。

仅是软件

Day One不是一个服务,而仅仅是软件。信息的存储完全依赖iCloud或Dropbox,相当于他就是做一个“壳”,但这个壳真的做得好看好用。这样也好,你的信息就是你的,他完全不掌握任何信息,只要信赖iCloud,Dropbox就好。

多设备同步

Day One同时有iOS和Mac版。都很稳定,品质很好,iOS版做得比Mac版更精美。同步可以选择iCloud或者Dropbox,写日记时会自动记录当时的天气和地理位置。

Markdown

编辑内容时支持Markdown,如果熟悉md,会非常顺手,现在这篇文就是在他里面写的。

Tag

这个对我来说很重要,想要添加很方便,在tool bar上有标签标志,点击添加就好。同时提供了另一种方法,可以直接在文字中写 # + 文字 ,保存会自动作为这篇日记的tag。

每篇只有一张照片

每次写日记可以拍照上传一张照片,只有一张,想一篇日记多张照片(这应该也是用户问他们问得很多的问题),现在还不行。不过这样也有好处,就是够简单,一张照片就是一个故事。

在未来他们可能会添加视频功能,推出Android版本。不过还是得说一句他们改进的速度非常慢,用了半年时间才把Mac版的tag功能加上。

链接: Day One.