用Markdown进行写作

什么是Markdown呢?简单来说,Markdown就是赋予了普通文本文件格式化的功能,同时又保持了文本文件的简洁。Markdown简单易用,既解决了我需要一款轻量级编辑器的需求,又解决了文章排版的问题。可以说是一个完美的解决方案。

Markdown的解决方案很多,在线的话可以使用简书;Mac OS上的话,Mou几乎是不二之选;Windows上则可以使用MarkdownPad。

虽然简书已经有很多关于Markdown语法的总结,我还是要写一份自己的版本。因为以后写作不仅是在简书网站上,还包括Mou等。而各家的Markdown语法大体上一致,但还是有一些小小的区别。因此本文也会随时更新。

闲话不多说,言归正传。通常来说,我编辑一份文档,需要用的格式大致有如下几种:

  • 分级的标题
  • 列表项
    • 有序列表
    • 无序列表
    • 列表的嵌套
  • 用黑体、斜体来表示强调
  • 超链接
  • 插入图片
  • 程序源代码的展示
  • 引用

OK,有了以上的这些格式,那么完全可以写出一份排版非常漂亮的文章了。而这些格式在Markdown中,都可以轻易的实现。下面分别用具体例子的来说明。

分级标题

Markdown中标题一共分为6级

# 一级标题
## 二级标题
### 三级标题
#### 四级标题
##### 五级标题
###### 六级标题

显示效果如下:

一级标题

二级标题

三级标题

四级标题

五级标题
六级标题

注:Markdown的语法其实跟HTML是兼容的,所以文字的分段是通过空白行来实现的;所以,仅仅是一个换行符有时并不能实现文字的分段。同时,多个空白行也只会被当做一个来处理。

分级标题还有一个方式,但是只能实现两种级别的标题格式:

一级标题
=======(只需一个=就可以显示出效果,为了美观,可以让=的长度跟标题一样长)
二级标题
-------

显示效果如下:

一级标题

二级标题


列表项

列表项的实现非常简单。无序列表可以使用*、-或+开头,然后空一格开始写列表项的标题即可。如果需要嵌套,使用tab键即可。如下所示:

* 中国
    * 北京
    * 深圳
    * 成都
* 美国
    - 纽约
    - 费城
* 法国
    + 巴黎
    + 马赛 
* 英国

显示效果如下:

  • 中国
    • 北京
    • 深圳
    • 成都
  • 美国
    • 纽约
    • 费城
  • 法国
    • 巴黎
    • 马赛
  • 英国

如果需要有序列表的话,那么使用数字+小数点+空格+列表项即可。如下所示:

1. 冠军
2. 亚军
1. 季军 (注:数字可以不连续,但是显示出来的列表项编号是连续的)
4. 殿军

效果如下:

  1. 冠军
  2. 亚军
  3. 季军
  4. 殿军

不过有序列表好像无法指定起始编号,不过这一点无伤大雅。


强调

在文章中,一般通过文字的黑体、斜体效果来表示强调。实现如下:

**黑体** __黑体__
*斜体*   _斜体_
~~删除~~

显示效果如下:

黑体 黑体

斜体 斜体

删除


超链接

格式:

[蜗牛独独](http://weibo.com/snaillonely)

显示效果:

蜗牛独独 <-- HIT ME

因为Markdown于HTML是兼容的,所以电子邮件可以用这种格式:

[给我写信](mailto:snaillonely@qq.com)

显示效果:

给我写信 <-- HIT ME

它的显示跟一般的url没有区别,不过你可以点击一下试试。


图片

格式:

![Mou](http://25.io/mou/Mou_128.png)

显示效果:

Mou
Mou

图片和超链接的唯一区别就是一开始那个感叹号。


源代码

作为一个程序猿,在写一些技术文档的时候,常常苦于无法排版出一份漂亮的代码。在Markdown下,事情就变得很简单了。在Mou下,仅仅是使用个Tab键,就可以编辑代码;而在简书下,貌似不支持Tab键,不过可以使用4个空格代替(每次换行都要输入若干个空格,真心不方便)。

格式

    #include <iostream>
    using namespace std;
    
    int main()
    {
        cout << "Hello world" << endl;
        
        return 0;
    }

显示效果:

#include <iostream>
using namespace std;

int main()
{
    cout << "Hello world" << endl;
    
    return 0;
}

另一个代码格式就更简单了,格式如下:

```
#include <stdio.h>
int main()
{
    printf("Hello world\n");
    
    return 0;
}
```

显示效果:

#include <stdio.h>
int main()
{
    printf("Hello world\n");
    
    return 0;
}

在Mou下,代码的编辑就显得非常方便,换行后还能够保持缩进。

还有一个行内代码的格式,如下:

在Linux命令行下,可以使用`rm -rfv 目录名`来强制删除一个文件夹

显示效果如下:

在Linux命令行下,可以使用rm -rfv 目录名来强制删除一个文件夹


引用

格式:

> 你在桥上看风景 
> 
> 看风景的人在楼上看你

显示效果:

你在桥上看风景

看风景的人在楼上看你

嵌套引用格式:

格式:

> 你在桥上看风景
>
> > 看风景的人在楼上看你
>
> 明月装饰了你的窗子,你装饰别人的梦

显示效果:

你在桥上看风景

看风景的人在楼上看你

明月装饰了你的窗子,你装饰了别人的梦


表格

格式:

First Header | Second Header | Third Header
:------------|:-------------:|------------:
Content   | Content    | Content
Left      | Center     | Right

这个样式还比较美观,如下的格式也能得到同样的显示效果:

First Header | Second Header | Third Header
:-|:-:|-:
Content|Content|Content
Left|Center|Right

显示效果

First Header Second Header Third Header
Content Content Content
Left Center Right

上面的例子不仅显示了表格是如何写成,还展示了怎样设置文字的对齐方式。


杂项

水平线

格式:

--- (三个及以上即可,一定注意与上一行文字保持一个空行)

*** (同上)

显示效果:



脚注

格式:

This is a footnote.[^1]
This is another footnote. [^2]

[^1]: Footnote 1. (注:脚注显示在文章的末尾)
[^2]: Footnote 2.

显示效果:

This is a footnote.[1]

This is another footnote.[2]


锚点

再一次强调,Markdown与HTML是兼容的,所以很多HTML的功能也能够在Markdown中实现,比如锚点:

格式:

[some text](id:anchor) (注: 设置锚点)

[link](#anchor)        (注: 使用锚点)

显示效果:

some text

link

注:此项功能简书不支持。


最后,编辑好的文档可以通过Mou等Markdown编辑器导出pdf格式的文档保存或者分享给别人。


  1. Footnote 1.

  2. Footnote 2.

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 194,242评论 5 459
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 81,769评论 2 371
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 141,484评论 0 319
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 52,133评论 1 263
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 61,007评论 4 355
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 46,080评论 1 272
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 36,496评论 3 381
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 35,190评论 0 253
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 39,464评论 1 290
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 34,549评论 2 309
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 36,330评论 1 326
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 32,205评论 3 312
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 37,567评论 3 298
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 28,889评论 0 17
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 30,160评论 1 250
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 41,475评论 2 341
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 40,650评论 2 335

推荐阅读更多精彩内容

  • 写在前面 之前在 CSDN 写过一段时间的博客,使用的是传统的文本。最近利用 Github+Hexo 搭建了一个静...
    Lucky_Light阅读 1,601评论 0 21
  • 为什么学习Markdown 自从搭建了 Hexo 博客之后,发现还有 Markdown 这种写文章的方法,想到以后...
    lifeColder阅读 20,087评论 10 216
  • 转载请注明原作者,如果你觉得这篇文章对你有帮助或启发,也可以来请我喝咖啡[http://ww2.sinaimg.c...
    Te_Lee阅读 1,236,584评论 214 3,826
  • 导语: Markdown 是一种轻量级的「标记语言」,看到这里请不要被「标记」、「语言」所迷惑,Markdown ...
    阶梯阅读 3,391评论 0 2
  • 咖菲菲阅读 300评论 0 0