用Markdown优雅的写文章

@date:2017-07-02 19:50:00

简介 #

Markdown是一种可以使用普通文本编辑器编写的标记语言,通过简单的标记语法,它可以使普通文本内容具有一定的格式。

简单点来说,Markdown是文本标记语言,在普通文本的基础上加了一些特殊标记。这些特殊标记会被Markdown编辑器渲染成特定样式。Markdown的后缀一般是.md或者.markdown

由于Markdown语法简洁明了、学习容易,而且功能比纯文本更强,因此有很多人用它写博客或者文档。本文就是使用Markdown写的。

相比传统富文本编辑器或者word编辑器,使用Markdown生成的文档样式美观、统一,而且码字过程中我们无需去关心样式问题,只需要专注写作可以。由于Markdown就是文本,我们可以使用任何文本编辑器打开,如Sublime、Notepad++等等。

Markdown对于代码的渲染也非常好,只需要简单的敲出代码段落标记,渲染出来的代码非常漂亮。甚至我们还可以统一设置渲染样式。基于这些特点,Markdown深受程序员的喜欢。

除此之外,我们还可以快速将Markdown转化为演讲PPT、Word产品文档、LaTex论文甚至是用非常少量的代码完成最小可用原型。在数据科学领域,Markdown已经被确立为科学研究规范,极大地推进了动态可重复性研究的历史进程。

初见Markdown #

那么,Markdown的语法难吗?不难,常用的标记就几个,而且都非常好记。

1. 斜体和粗体 #

文字两边使用使用 *** 表示体和粗体

示例:

这是 斜体,这是 粗体

2. 分级标题 #

在行首加井号表示不同级别的标题 (H1-H6),例如:# H1, ## H2, ### H3#### H4

使用了分级标题,在文章头部使用[TOC]标记可以自动生成全文目录(部分编辑器支持)。

3. 外链接 #

使用 [描述](链接地址) 为文字增加外链接。

示例:

这是去往 本人博客 的链接。

4. 无序列表 #

使用 *+- 表示无序列表。注意标记后面有空格。

示例:

  • 无序列表项 一
  • 无序列表项 二
  • 无序列表项 三

5. 有序列表 #

使用字和表示有序列表。注意字和后面有空格。

示例:

  1. 有序列表项 一
  2. 有序列表项 二
  3. 有序列表项 三

6. 文字引用 #

使用 > 表示文字引用。

示例:

野火烧不尽,春风吹又生。

7. 行内代码块 #

使用 `代码` 表示行内代码块。

示例:

让我们聊聊 html

8. 代码块 #

使用下面标记标识代码块:
```
这是代码块
```
且标记需要紧贴左边,不能有空格。效果示例:

int max(int a,int b){
    if(a>b) return a;
    else return b;
}

也可以使用 四个缩进空格 表示代码块。

示例:

这是一个代码块,此行左侧有四个不可见的空格。

9. 插入图像 #

使用 ![描述](图片链接地址) 插入图像。

示例:

我的头像
我的头像

10.段落和换行 #

使用一个或多个 空行 分隔内容段来生成段落
在行末输入2个或以上 空格 再回车来生成换行

更多语法查看文末 有用的资源。

俗话说,好记性不如烂笔头,练几遍就知道了。这里推荐一个在线的Markdown编辑器,供大家练手使用:
https://www.zybuluo.com/mdeditor

哪些网站支持 #

  • Github
  • 码云
  • Cmd-Markdown
  • 知乎
  • 博客园
  • CSDN
  • 简书
  • segmentfault
  • 有道云笔记
  • Ghost
  • Typecho

Markdown编辑器 #

在线编辑器 #

1、Cmd Markdown 编辑阅读器 - 作业部落出品
https://www.zybuluo.com/mdeditor
2、StackEdit – Editor
https://stackedit.io/editor

编辑器工具 #

1、Editor.md -- 一款开源的Markdown编辑器
https://pandao.github.io/editor.md/examples/index.html
2、sparksuite/simplemde-markdown-editor
https://github.com/sparksuite/simplemde-markdown-editor

编辑器插件 #

1、markdown preview:一款Sublime插件,支持生成渲染好的html
2、SegmentFault/HyperDown: 一个结构清晰的,易于维护的,现代的PHP Markdown解析器
3、erusev/parsedown: Markdown Parser in PHP
https://github.com/erusev/parsedown
4、thephpleague/html-to-markdown: Convert HTML to Markdown with PHP
https://github.com/thephpleague/html-to-markdown

有用的资源 #

1、Markdown 语法说明(简体中文版)
http://www.appinn.com/markdown/
2、Cmd Markdown 简明语法手册
https://www.zybuluo.com/mdeditor?url=https://www.zybuluo.com/static/editor/md-help.markdown

Build by Loppo 0.6.14