本文简单记下自已常用的Markdown语法,方便日后使用。
写在前面
之前一直琢磨着,如何让博文写起来更方便同时更加美观。Windows Live Writer是我能找到最好用的离线博客工作,但很多地方差强人意,比如代码高亮、数学公式、表格(还有一点,只能在Windows下用,需要切换系统)。在一次找如何更方便将数学公式插入到Gmail,了解到了Markdown,果真大大增加了邮件的可读性(经常要附一些代码,有时还插入公式)。最近,突然想到,说不定可以用Markdown写博文,一搜还真有而且还很成熟。了解了下,都说StackEdit好,果断付了4.5欧(第一次花钱买软件,mark一下),这篇博文正是用StackEdit所写。
Markdown语法
基本用法
- 加粗用两个星号括起来
**text**
或者__text__
; - 斜体用一组星号括起来
*text*
或者_text_
; - 段落用一个或者一个以上的空行表示;
- 水平线只需要在一行输入3个或者3个以上的
连字符、星号、下划线
(hyphens, asterisks, or underscores, 中间可以有空格),如:----------
、* * *
; - 删除线用两个波浪线括起来
~~text~~
;
引用用右尖括号开头>
,举例如下:
This is blockquoted text.
This is blockquoted text.
内嵌超链接,将超链接写在文本中,如SparkandShine:
SparkandShine [SparkandShine](http://sparkandshine.com/)
SparkandShine [SparkandShine](http://sparkandshine.com/"with a title")
Links: Reference,用于多处使用相同的超链接,如SparkandShine:
[SparkandShine][1]:
[1]: http://sparkandshine.com/ "with a title" #可以放在任何地方
Title和Head
Title可以用任意个的= 或 -
,值得注意的是,= -
与Title不能有空行。
标题,用井号个数表示标题级别,如下:
# 一级标题
## 二级标题
### 三级标题
#### 四级标题
##### 五级标题
###### 六级标题
代码
内嵌代码,通常用于文中插入命令、短代码,用重音符括起来,如:`code` 。
代码块,用3个重音符(单独成行,重音符后面可加编程语言名称)括起来,如:
```python
int i
```
列表
无序列表,用+ - *
(plus, hyphens or asts,符号后面需加一个标记。举例如 下:
- one
- two
- three
有序列表,加上数字,如1. 2. 3.
,举例如下:
- one
- two
- three
嵌套列表,低一层次缩进4个空格或者一个制表符,举例如下:
- one
- one
- two
- two
表格
用-
表示行分隔符,用|
表示列分隔符,举例如下:
| Item | Value | Qty |
| :------- | ----: | :---: |
| Computer | $1600 | 5 |
| Phone | $12 | 12 |
| Pipe | $1 | 234 |
得到的效果如下,双冒号表示居中对齐:
Item | Value | Qty |
---|---|---|
Computer | $1600 | 5 |
Phone | $12 | 12 |
Pipe | $1 | 234 |
插入图片
如果图片是url地址,那跟插入超链接的方法一样。但怎么插入本地的图片呢?
插入目录
目录用 [TOC]
,举例如下:
有了这些,博文的可读性大大增强了,enjoy it:-)
总结
尽管Markdown可以大大增强博文可读性,但StackEdit并不是十分给力,存在不足如下:
- 自动备份:可以同步到Dropbox,Google Drive,但每新建一个文件都需要手动填入文件名,而不是设置一个Dropbox文件夹,而后自动保存;
- 发布到wordpress:如果是在wordpress.com注册倒方便,但要是个人博客,需要安装Jetpack插件,我没安装成功,提示“XML-RPC server accepts POST requests only.”。我markdown格式的文本复制到wordpress下的wp-markdown编辑器,生成的html不同于在StackEdit预览区的内容。最后,我将markdown另存为html文件,拷贝到windows live writer。(PS: 总结部分是在WLW下写的);
- 插入图片:只能插入带url的图片,插入本地图片甚是麻烦;(不过这一点,不能推到StackEdit)
- 编辑文本:在StackEdit下写markdown,并不是很友好,体现在:编辑区与预览区不同步;
- 实际效果:由上面展示的实例可见,实际效果并不理想。(当然,这可能跟我主题有关)
参考资料:
[1]markdown-guide’s documentation: Markdown Basics
[2]Markdown 语法说明 (简体中文版)
微信赞赏
支付宝赞赏