引言

找一个合适的编辑器是很麻烦的,曾经用emlog的时候每次做笔记,写博客的时候很是受伤,经常是发布了之后还要修改其样式,因为总是会多出来N多无用的空格之类的,很是不爽.而其他的"所见即所得"页不慎喜欢(强迫症?).于是百般寻找,最后发现了typecho,发现了Markdown,它的简单却不失强大让我可以专心的写文章,于是一见钟情.但任何一个新东西都是需要学习的,于是有了这个快速入门.希望对看得到的人又帮助吧:D

关于换行

平时我们习惯了换行,enter一下就是换行,在Markdown里面却不是这样.必须得enter两次,也就是我们要看得出来它是有"空"行才行.

和HTML的转换

Markdown还是很给力的,会自动转换为html代码,当然它也有不是很方便的时候.如不能输入图片的宽和高,这时候就得用<img>标签的widthheight属性了.如果你很喜欢用html,也行,Markdown是支持原生html的,但是有几个小问题需要注意

  1. 在一些如<div>,<table>,<pre>,<p>等的HTML区块标签时必须在其前后加上空行与其他内容隔开,并且他们的开始标签和结束标签不能用制表符tab空格来隔开
  2. 在HTML表前体是输入Markdown语法是没有效果的

区块

标题

一级标题加在标题下加1个以上的`===`符号,如
我是一级标题
======
效果如下

我是一级标题

二级标题在标题下加1个以上的-(减号)符号,如
我是二级标题
----
效果如下

我是二级标题

第二种方法是在标题前面加上若干个#符号,如
#我是H1
#我是H2
#我是H3
....
#我是H6

引用

当我们要引用一段话或者一句话的时候,直接在该句话的前面加上>符号即可.如

>我现在被引用啦,我真的被引用啦
效果如下:

我现在被引用啦,我真的被引用啦

关于嵌套引用

我们要在引用里面嵌套引用或者是在引用里面使用其他的Markdown语法都是可以的.比如我要在下面这样引用:

>我是外面的引用
>>恩,我是引用的引用
>>>我是引用的引用的引用,我还要加一个代码`echo('hello Markdown')`

>>我是引用额引用

>我是外面的引用

效果如下:

我是外面的引用

恩,我是引用的引用

恩,我是引用的引用的引用,我还要加一个代码echo('hello Markdown')

恩,我是引用的引用

恩,我是外面的引用

这里说明一下,如果你进入了引用里面又用了引用,你退出这个里面的引用时必须要加一个空行才能退出,不能想当然的吧>符号少写一个,Markdown解析器不是这样解析的...

列表

无序列表

+,-,*都可,下面用+做示范,其他两个相同,具体如下:

+ 第一
+ 第二
+ 第三

效果如下图:

  • 第一
  • 第二
  • 第三

有序列表

1.来表示('.'号后面有一个空格),示例代码如下:

1. 第一
2. 第二
3. 第三

效果如下:

  1. 第一
  2. 第二
  3. 第三

注意数字可以随便填,markdown解析器仍然可以按照正确的顺序来选择,比如:

3. 第一
2. 第二
5. 第三

效果如下:

  1. 第一
  2. 第二
  3. 第三

虽然如此,还是建议老老实实别偷懒,以后以后markdown可能会支持有序列表的start属性.

notes:列表内可以使用段落,每个段落用tab或者4个空行,具体如下:

1. 这是列表1第一段

    这是列表2第二段

2. 这是列表2第一段

    这是列表2第二段

效果如下:

  1. 这是列表1第一段

    这是列表1第二段

  2. 这是列表2第一段

    这是列表2第二段

代码

其实我最关心的就是这个代码问题了,嘿嘿,在Markdown里面很简单,一个tab或者4个空格就可以搞定,酷毙了,比如我要显示echo 'hello Markdown',只需要这样:

(我是四个空行,要不是TAB也行)echo 'hello Markdown'

效果如下图

echo 'hello Markdown'

区段

链接

链接的语法有两种,一种是行内式,一种是参考式.

行内式

格式:[这是我的博客]('http://pjf.name' '疯子的自留地')

它会转换为这样的html标签:

<a href="http://pjf.name" title="疯子的自留地">这是我的博客</a>

参考式

格式:[这是我的博客][1]
你得找一个地方放你的链接:[1]: http://pjf.name '疯子的自留地'

它会转换为这样的html标签:

<a href="http://pjf.name" title="疯子的自留地">这是我的博客</a>

tips:参考式的索引(即上面的1)可以不用写,只保留[这是我的博客],然后你的链接写成[这是我的博客]:http:/pjf.name '疯子的自留地'即可

图片

图片的语法和链接的语法差不多,也有行内式和参考式两种.

行内式

格式:![图片的alt](图片路径)
或者:![图片的alt](图片的路径 '我是title文字')

参考式

格式:![图片的alt][索引]
链接:![索引]:图片的链接 '我是title文字'

强调

在要强调的字两边加上*或者_符号即可,如*我会是强调样式*,效果如下图:

我会是强调样式

粗体

在要加粗的字两边加上**或者__即可,如`我是粗体``,效果如下图:

我是粗体

字段内代码

要在字段内加入代码很简单,把代码用`框住就行,但是...如果代码内含有`符号怎么办呢?用多个`符号来作为行内代码的标签,但注意如果你只是单纯输入若干个`字符,同时要注意标签内的`符号左右两侧加1个空格,如

`` ` ``

效果就是:

`

自动链接

如果想要在你手动输入网址或者邮箱的时候让浏览器可以响应,则只需要在你想添加的链接两侧加上<>符号,如<http://pjf.name>,或者邮箱<abc@china.com>,即可,如果是链接会自动转为<a>标签,如果是邮箱就会直接把我们的文字字符转为16进制字符,这样可以在一定程度上阻止邮箱机器人

反斜杠

跟编程语言一样,反斜杠\可以让Markdown解释器不转换那些我们不想转换的标签,如用*这是重要的*我们不想表示强调而是就输出*号,只需要在*号处输入\即可,即这样:\*这是重要的\*.下面是反斜杠可以转换的

\
`
*
*
_   
{}
[]
()
#
+
-
.
!

:Sublime2+MarkdownEditing插件

sublime安装了package control后install搜索安装MarkdownEditing插件.写文章怎一个爽字了得~~~

特点:

  1. 安装后针对 md\mdown\mmd\txt 格式文件启用插件。颜色方案仿 Byword 及 iA writer。
  2. 自动匹配星号(*)、下划线(_)及反引号(`),选中文本按下以上符号能自动在所选文本前后添加配对的符号,方便粗体、斜体和代码框的输入。
  3. 直接输入配对的符号后按下退格键(backspace),则两个符号都会被删除;直接输入配对的符号后按下空格键,则会自动删除后一个。
  4. 对“选中文字后输入左括号”这一动作进行了调整,以便插入 markdown 链接。
  5. 拷贝一个链接,选中文本后按下 ⌘⌥V 会自动插入内联链接。
  6. 拷贝一个链接,选中文本后按下 ⌘⌥R 会自动插入引用链接。
  7. ⌘K 插入链接;⌘⇧K 插入图片。
  8. ⌘B 和 ⌘I 分别用于加粗体和斜体。
  9. 选中文本后按下 # 会自动在文本前后进行配对,可重复按下来定义标题级别,还可用 ⌘⇧空格 来增加 # 与所选文本之间的空格(也是自动配对的)。

PS:

  1. 有些快捷键可能与系统的一些发生冲突,可以编辑~/Library/Application Support/Sublime Text2/Packages/MarkdownEditing/Default.sublime-keymap改掉。另外还有一些设置可以在~/Library/Application Support/Sublime Text 2/Packages/MarkdownEditing/Markdown.sublime-settings中进行修改。
  2. 比如除了默认的颜色主题外,MarkdownEditing还提供了一个高亮显示编辑行MarkdownEditor-Focus,就可以在 Markdown.sublime-settings这个文件中找到并去掉注释保存生效。

参考文章:

http://wowubuntu.com/markdown/

http://lucifr.com/2012/07/12/markdownediting-for-sublime-text-2/