Markdown简要笔记(使用StackEdit)

本文简单记下自已常用的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.,举例如下:

  1. one
  2. two
  3. three

嵌套列表,低一层次缩进4个空格或者一个制表符,举例如下:

  • one
    1. one
    2. 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 语法说明 (简体中文版)

发表评论

电子邮件地址不会被公开。 必填项已用*标注