写了一个月的博客,忽然感觉Markdown编辑器比较好用,于是就下载了一个本地的Markdown编辑软件学习了一下,刚好软件里自带了一篇英文的指示文档,顺便翻译了一下,通过这个过程也大致熟悉了Markdown语法,以后都会用Markdown来写文章了。
通过Markdown编辑器发布了几篇博客,发现以下几个标签比较常用:
- 标题标签
- 引用标签
- 嵌入代码标签
- url标签
- 图片标签
都整理在正文里了。
本篇文章的Markdown文件我也放到了github上,地址在这里,里面也放了mac版的MWeb编辑器可供下载。
以下为正文:
Markdown语法讲解及MWeb使用教程
理念
Markdown想要将易读易写变为可能。
可读性是最为重要的,一份公开的Markdown式的文件应该如他原来的样子一样,简单明了,不会看起来像被标签整理过,也不会看起来像被命令格式化过。
Markdown语法的目的只有一个:成为大家接受的网页写作的标准格式。
提示
在编辑器中,你可以用Command+R
或者Command+4
来预览你正在书写的文档。
标题
例子:
# 这是一个 `<h1>` 标签
## 这是一个 `<h2>` 标签
###### 这是一个 `<h6>` 标签
呈现的结果:
这是一个 <h1>
标签
这是一个 <h2>
标签
这是一个 <h6>
标签
强调
例子:
*这一行格式为斜体*
_这一行格式也为斜体_
**这一行将被加粗**
__这一行也会被加粗__
_也 **可以** 联合使用这种格式_
呈现的结果:
这一行格式为斜体
这一行格式也为斜体
这一行将被加粗
这一行也会被加粗
也 可以 联合使用这种格式
换行
在一行的结尾输入两次空格+enter
即可实现换行效果。
如果想要只输入enter即实现换行效果的话,可以在Preferences
- Themes
- Translate newlines to <br> tags
进行设置。
列表
无序列表
例子:
* 无序队列条目1 `* + SPACE`
* 无序队列条目2
* Item 2a unordered list `TAB + * + SPACE`
* Item 2b
呈现的结果:
- 无序队列条目1
* + SPACE
- 无序队列条目2
- Item 2a unordered list
TAB + * + SPACE
- Item 2b
有序列表
例子:
1. 有序队列条目1 `Number + . + SPACE`
2. 有序队列条目2
3. 有序队列条目3
1. Item 3a ordered list `TAB + Number + . + SPACE`
2. Item 3b
呈现的结果:
- 有序队列条目1
Number + . + SPACE
- 有序队列条目2
- 有序队列条目3
- Item 3a ordered list
TAB + Number + . + SPACE
- Item 3b
任务清单
例子:
- [ ] 任务未完成 `- + SPACE + [ ]`
- [x] 任务完成 `- + SPACE + [x]`
呈现的结果:
- [ ] 任务未完成
- + SPACE + [ ]
- [x] 任务完成
- + SPACE + [x]
图片
例子:
![GitHub set up](https://help.github.com/assets/images/site/set-up-git.gif)
Format: ![](url)
快捷键:Control + Shift + I
呈现的结果:
使用MWeb,你可以使用-w + 数字
来设置图片的宽度值,例如:
链接
例子:
email <example@example.com>
[GitHub](http://github.com)
autolink <http://www.github.com/>
快捷键:Control + Shift + L
呈现的结果:
email example@example.com
GitHub
autolink http://www.github.com/
引用
例子:
毛主席说过:
> 真理只有一个,而究竟谁发现了真理,不依靠主观的夸张,而依靠客观的实践。
> 只有千百万人民的革命实践,才是检验真理的尺度。
快捷键:Command + Shift + B
呈现的结果:
毛主席说过:
真理只有一个,而究竟谁发现了真理,不依靠主观的夸张,而依靠客观的实践。
只有千百万人民的革命实践,才是检验真理的尺度。
嵌入代码
例子:
I think you should use an
`<addr>` `code` element here instead.
快捷键:Command + K
呈现的结果:
I think you should use an<addr>
code
element here instead.
嵌入多行代码
例子:
```
js
function fancyAlert(arg) {
if(arg) {
$.facebox({div:'#foo'})
}
}
```
快捷键:Command +Shift+ K
呈现的结果:
js
function fancyAlert(arg) {
if(arg) {
$.facebox({div:'#foo'})
}
}
希望对你有帮助。