Windows 下博客编辑利器 工具 Typora

认识与入门 Markdown

Markdown 是一种轻量级的「标记语言」,它的优点很多,目前也被越来越多的写作爱好者,撰稿者广泛使用。看到这里请不要被「标记」、「语言」所迷惑,Markdown 的语法十分简单。常用的标记符号也不超过十个,这种相对于更为复杂的HTML 标记语言来说,Markdown 可谓是十分轻量的,学习成本也不需要太多,且一旦熟悉这种语法规则,会有一劳永逸的效果。

认识 Markdown

在刚才的导语里提到,Markdown 是一种用来写作的轻量级「标记语言」,它用简洁的语法代替排版,而不像一般我们用的字处理软件 Word 或 Pages 有大量的排版、字体设置。它使我们专心于码字,用「标记」语法,来代替常见的排版格式。例如此文从内容到格式,甚至插图,键盘就可以通通搞定了。

目前来看,支持 Markdown 语法的编辑器有很多,包括很多网站(例如 简书)也支持了 Markdown 的文字录入。Markdown 从写作到完成,导出格式随心所欲,你可以导出 HTML 格式的文件用来网站发布,也可以十分方便的导出 PDF 格式,这种格式写出的简历更能得到 HR 的好感,甚至可以利用 CloudApp 这种云服务工具直接上传至网页用来分享你的文章,全球最大的轻博客平台 Tumblr,也支持使用 Mou 这类 Markdown 工具进行编辑并直接上传。

Markdown 官方文档

这里可以看到官方的 Markdown 语法规则文档,当然,后文我也会用自己的方式,阐述这些语法在实际使用中的用法。

创始人 John Gruber 的 Markdown 语法说明

Markdown 中文版语法说明

使用 Markdown 的优点

专注你的文字内容而不是排版样式,安心写作。

轻松的导出 HTML、PDF 和本身的 .md 文件。

纯文本内容,兼容所有的文本编辑器与字处理软件。

随时修改你的文章版本,不必像字处理软件生成若干文件版本导致混乱。

可读、直观、学习成本低。

使用 Markdown 的误区

Markdown 旨在简洁、高效,也由于 Markdown 的易读易写,人们用不同的编程语言实现了多个版本的解析器和生成器。这就导致了目前不同的 Markdown 工具集成了不同的功能(基础功能大致相同),例如流程图与时序图,复杂表格与复杂公式的呈现。

虽然功能的丰富并没有什么本质的缺点,但终归有些背离初衷,何况在编写的过程中很费神,不如使用专业的工具撰写来的更有效率,所以如果你需实现复杂功能,专业的图形界面工具会更加方便。

当然,如果你对折腾这些不同客户端对 Markdown 的定制所带来高阶功能感到愉悦的话,那也是无可厚非的。

Markdown 语法的简要规则

标题

用 Markdown 书写时,只需要在文本前面加上『# 』即可创建一级标题。同理,创建二级标题、三级标题等只需要增加『# 』个数即可,Markdown 共支持六级标题。如下所示:

# 一级标题

## 二级标题

### 三级标题

#### 四级标题

##### 五级标题

###### 六级标题

点击预览可以看到效果:


锚点

Coding 会针对每个标题,在解析时都会添加锚点 id,如

# 锚点

会被解析成:

<h1 id="user-content-锚点">锚点</h1>

注意我们添加了一个 user-content- 的前缀,所以如果要自己添加跳转链接要使用 Markdown 的形式,且链接要加一个 user-content- 前缀,如:

[访问链接](#user-content-锚点);

引用

Markdown 标记区块引用和 email 中用 『>』的引用方式类似,只需要在整个段落的第一行最前面加上 『>』 :

> Coding.net 为软件开发者提供基于云计算技术的软件开发平台,包括项目管理,代码托管,运行空间和质量控制等等。

效果图如下:


区块引用可以嵌套,只要根据层次加上不同数量的『>』:

> 这是第一级引用。

>

> > 这是第二级引用。

>

> 现在回到第一级引用。

效果图如下:


引用的区块内也可以使用其他的 Markdown 语法,包括标题、列表、代码区块等:

> ## 这是一个标题。

> 1. 这是第一行列表项。

> 2. 这是第二行列表项。

>

> 给出一些例子代码:

>

> return shell_exec(`echo $input | $markdown_script`);

效果图如下:


列表

列表项目标记通常放在最左边,项目标记后面要接一个字符的空格。

无序列表:使用星号、加号或是减号作为列表标记

- Red

- Green

- Blue

效果图如下:


有序列表:使用数字接着一个英文句点

1. Red

2. Green

3. Blue

效果图如下:


如果要在列表项目内放进引用,那『>』就需要缩进:

*  Coding.net有以下主要功能:

   > 代码托管平台

   > 在线运行环境    

   > 代码质量监控    

   > 项目管理平台

效果图如下:


代办列表: 表示列表是否勾选状态(注意:[ ] 前后都要有空格)

- [ ] 不勾选

- [x] 勾选

效果图如下:


代码

只要把你的代码块包裹在 “` 之间,你就不需要通过无休止的缩进来标记代码块了。 在围栏式代码块中,你可以指定一个可选的语言标识符,然后我们就可以为它启用语法着色了。 举个例子,这样可以为一段 Ruby 代码着色:

```ruby

require 'redcarpet'

markdown = Redcarpet.new("Hello World!")

puts markdown.to_html

```

效果图如下:


强调

在Markdown中,可以使用 * 和  _  来表示斜体和加粗。

斜体

*Coding,让开发更简单*

_Coding,让开发更简单_

效果图如下:


加粗

**Coding,让开发更简单**

__Coding,让开发更简单__

效果图如下:


自动链接

方括号显示说明,圆括号内显示网址, Markdown 会自动把它转成链接,例如:

[超强大的云开发平台Coding](http://coding.net)

效果图如下:


表格

在 Markdown 中,可以制作表格,例如:

First Header | Second Header | Third Header

------------ | ------------- | ------------

Content Cell | Content Cell  | Content Cell

Content Cell | Content Cell  | Content Cell

效果图如下:


或者也可以让表格两边内容对齐,中间内容居中,例如:

First Header | Second Header | Third Header

:----------- | :-----------: | -----------:

Left         | Center        | Right

Left         | Center        | Right

效果图如下:


分割线

在 Markdown 中,可以使用 3 个以上『-』符号制作分割线,例如:

这是分隔线上部分内容

---

这是分隔线上部分内容

效果图如下:


图片

Markdown 使用了类似链接的语法来插入图片, 包含两种形式: 内联引用.

内联图片语法如下:

![Alt text](/path/to/img.jpg)

![Alt text](/path/to/img.jpg "Optional title")

也就是:

一个惊叹号『!』

接着一个方括号,里面是图片的替代文字

接着一个普通括号,里面是图片的网址,最后还可以用引号包住并加上 选择性的『title’』文字。

引用图片语法如下:

![Alt text][id]

『id』 是图片引用的名称. 图片引用使用链接定义的相同语法:

[id]: url/to/image "Optional title attribute"

流程图

Markdown 编辑器已支持绘制流程图、时序图和甘特图。通过 mermaid 实现图形的插入,点击查看 更多语法详情

```graph

graph TD;

   A-->B;

   A-->C;

   B-->D;

   C-->E;

   E-->F;

   D-->F;

   F-->G;

```

效果图如下:


时序图

```graph

sequenceDiagram

   participant Alice

   participant Bob

   Alice->John: Hello John, how are you?

   loop Healthcheck

       John->John: Fight against hypochondria

   end

   Note right of John: Rational thoughts

prevail...

   John-->Alice: Great!

   John->Bob: How about you?

   Bob-->John: Jolly good!

```

效果图如下:


甘特图

```graph

gantt

       dateFormat  YYYY-MM-DD

       title Adding GANTT diagram functionality to mermaid

       section A section

       Completed task            :done,    des1, 2014-01-06,2014-01-08

       Active task               :active,  des2, 2014-01-09, 3d

       Future task               :         des3, after des2, 5d

       Future task2               :         des4, after des3, 5d

       section Critical tasks

       Completed task in the critical line :crit, done, 2014-01-06,24h

       Implement parser and jison          :crit, done, after des1, 2d

       Create tests for parser             :crit, active, 3d

       Future task in critical line        :crit, 5d

       Create tests for renderer           :2d

       Add to mermaid                      :1d

```

效果图如下:


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

推荐阅读更多精彩内容

  • 1、定义: Markdown 是一种轻量级标记语言,创始人为约翰·格鲁伯(英语:John Gruber)。它允许人...
    零一_fb4d阅读 508评论 0 0
  • 欢迎关注微信公众号:北岛向南(id:nanzhouie) GitHub Pages:https://zhouie....
    zhouie阅读 4,830评论 4 72
  • 1. Markdown简介 2. Mou简介 3. Mou学习 1. Markdown简介 原文链接 http:/...
    刘大帅阅读 10,744评论 13 58
  • 关于Markdown 一整个学期下来,我觉得让我收获最大之一的是学会markdown语言。我们平常都是使用Word...
    Dacade阅读 927评论 0 2
  • 1、简介 小男孩哈里因车祸去了另一个世界,正等着去天蓝色的彼岸,但因牵挂着世间他所爱的人们,便偷偷与叫阿瑟的幽灵溜...
    嚼一口阳光阅读 345评论 0 0