引言
找一个合适的编辑器是很麻烦的,曾经用emlog的时候每次做笔记,写博客的时候很是受伤,经常是发布了之后还要修改其样式,因为总是会多出来N多无用的空格之类的,很是不爽.而其他的"所见即所得"页不慎喜欢(强迫症?).于是百般寻找,最后发现了typecho,发现了Markdown,它的简单却不失强大让我可以专心的写文章,于是一见钟情.但任何一个新东西都是需要学习的,于是有了这个快速入门.希望对看得到的人又帮助吧:D
关于换行
平时我们习惯了换行,enter一下就是换行,在Markdown里面却不是这样.必须得enter两次,也就是我们要看得出来它是有"空"行才行.
和HTML的转换
Markdown还是很给力的,会自动转换为html代码,当然它也有不是很方便的时候.如不能输入图片的宽和高,这时候就得用<img>标签的width和height属性了.如果你很喜欢用html,也行,Markdown是支持原生html的,但是有几个小问题需要注意
- 在一些如
<div>,<table>,<pre>,<p>等的HTML区块标签时必须在其前后加上空行与其他内容隔开,并且他们的开始标签和结束标签不能用制表符tab和空格来隔开 - 在HTML表前体是输入Markdown语法是没有效果的
区块
标题
一级标题加在标题下加1个以上的`===`符号,如
我是一级标题
======
效果如下
我是一级标题
二级标题在标题下加1个以上的-(减号)符号,如
我是二级标题
----
效果如下
我是二级标题
第二种方法是在标题前面加上若干个#符号,如
#我是H1
#我是H2
#我是H3
....
#我是H6
引用
当我们要引用一段话或者一句话的时候,直接在该句话的前面加上>符号即可.如
>我现在被引用啦,我真的被引用啦
效果如下:
我现在被引用啦,我真的被引用啦
关于嵌套引用
我们要在引用里面嵌套引用或者是在引用里面使用其他的Markdown语法都是可以的.比如我要在下面这样引用:
>我是外面的引用
>>恩,我是引用的引用
>>>我是引用的引用的引用,我还要加一个代码`echo('hello Markdown')`
>>我是引用额引用
>我是外面的引用
效果如下:
我是外面的引用
恩,我是引用的引用
恩,我是引用的引用的引用,我还要加一个代码echo('hello Markdown')恩,我是引用的引用
恩,我是外面的引用
这里说明一下,如果你进入了引用里面又用了引用,你退出这个里面的引用时必须要加一个空行才能退出,不能想当然的吧>符号少写一个,Markdown解析器不是这样解析的...
列表
无序列表
用+,-,*都可,下面用+做示范,其他两个相同,具体如下:
+ 第一
+ 第二
+ 第三
效果如下图:
- 第一
- 第二
- 第三
有序列表
用1. 来表示('.'号后面有一个空格),示例代码如下:
1. 第一
2. 第二
3. 第三
效果如下:
- 第一
- 第二
- 第三
注意数字可以随便填,markdown解析器仍然可以按照正确的顺序来选择,比如:
3. 第一
2. 第二
5. 第三
效果如下:
- 第一
- 第二
- 第三
虽然如此,还是建议老老实实别偷懒,以后以后markdown可能会支持有序列表的start属性.
notes:列表内可以使用段落,每个段落用tab或者4个空行,具体如下:
1. 这是列表1第一段
这是列表2第二段
2. 这是列表2第一段
这是列表2第二段
效果如下:
这是列表1第一段
这是列表1第二段
这是列表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][索引]
链接:![索引]:图片的链接 '我是title文字'
强调
在要强调的字两边加上*或者_符号即可,如*我会是强调样式*,效果如下图:
我会是强调样式
粗体
在要加粗的字两边加上**或者__即可,如**我是粗体**`,效果如下图:
我是粗体
字段内代码
要在字段内加入代码很简单,把代码用 ` 框住就行,但是...如果代码内含有 ` 符号怎么办呢?用多个 ` 符号来作为行内代码的标签,但注意如果你只是单纯输入若干个 ` 字符,同时要注意标签内的 ` 符号左右两侧加1个空格,如
`` ` ``
效果就是:
`
自动链接
如果想要在你手动输入网址或者邮箱的时候让浏览器可以响应,则只需要在你想添加的链接两侧加上<和>符号,如<http://pjf.name>,或者邮箱<abc@china.com>,即可,如果是链接会自动转为<a>标签,如果是邮箱就会直接把我们的文字字符转为16进制字符,这样可以在一定程度上阻止邮箱机器人
反斜杠
跟编程语言一样,反斜杠\可以让Markdown解释器不转换那些我们不想转换的标签,如用*这是重要的*我们不想表示强调而是就输出*号,只需要在*号处输入\即可,即这样:\*这是重要的\*.下面是反斜杠可以转换的
\
`
*
*
_
{}
[]
()
#
+
-
.
!
附:Sublime2+MarkdownEditing插件
sublime安装了package control后install搜索安装MarkdownEditing插件.写文章怎一个爽字了得~~~
特点:
- 安装后针对 md\mdown\mmd\txt 格式文件启用插件。颜色方案仿 Byword 及 iA writer。
- 自动匹配星号（*）、下划线（_）及反引号（`），选中文本按下以上符号能自动在所选文本前后添加配对的符号，方便粗体、斜体和代码框的输入。
- 直接输入配对的符号后按下退格键（backspace），则两个符号都会被删除；直接输入配对的符号后按下空格键，则会自动删除后一个。
- 对“选中文字后输入左括号”这一动作进行了调整，以便插入 markdown 链接。
- 拷贝一个链接，选中文本后按下 ⌘⌥V 会自动插入内联链接。
- 拷贝一个链接，选中文本后按下 ⌘⌥R 会自动插入引用链接。
- ⌘K 插入链接；⌘⇧K 插入图片。
- ⌘B 和 ⌘I 分别用于加粗体和斜体。
- 选中文本后按下 # 会自动在文本前后进行配对，可重复按下来定义标题级别，还可用 ⌘⇧空格 来增加 # 与所选文本之间的空格（也是自动配对的）。
PS:
- 有些快捷键可能与系统的一些发生冲突，可以编辑
~/Library/Application Support/Sublime Text2/Packages/MarkdownEditing/Default.sublime-keymap改掉。另外还有一些设置可以在~/Library/Application Support/Sublime Text 2/Packages/MarkdownEditing/Markdown.sublime-settings中进行修改。 - 比如除了默认的颜色主题外，
MarkdownEditing还提供了一个高亮显示编辑行MarkdownEditor-Focus，就可以在Markdown.sublime-settings这个文件中找到并去掉注释保存生效。
参考文章:
http://wowubuntu.com/markdown/
http://lucifr.com/2012/07/12/markdownediting-for-sublime-text-2/