6.5 10分钟掌握 Markdown

0. 引言

世面上有太多《Markdown 从新手到精通》的文章,我看了之后发现都是一些搞研发的人写的,虽然我也是研发,但是我觉得依然很研发,来看这一段:

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

你看,就这段内容,如果是一个小白来看,直接就晕了吧?什么是轻量级?什么是标记语言?我不是写作爱好者、撰稿人,我是不是不能用了?什么是标记符号?相对于 HTML 是什么意思?语法规则是英语语法么?在这个时代,有 3 个问题搞不清楚,小白一定放弃啊!

我也经常推荐 Markdown,很多人也问我什么是 Markdown,怎么学更好一些?既然没有好用的教程,我就自己写个符合元认知学习法的教程吧。本文的目标是:争取用 10 分钟的时间,让你学会 Markdown

下面,有个故事,你来跟着操作,不要跳步骤,有问题就先回答再推进,五分钟看完文章,你也一定掌握 Markdown!正文开始。

1. 角色扮演

下面,进入角色扮演环节,请你用 10 秒钟的时间,变成下面的角色——小 M

你是一个刚工作不久的文员,公司里刚刚完成一次关于「知识付费」的会议。你的同事 X 刚刚整理了一部分会议纪要,但是他家里临时有事请假去处理了。于是,老板让你把剩下的会议纪要完成,要求如下:

  • 先看懂同事 X是怎么做记录的;
  • 把领导的讲话按照同样的方式继续整理完成。

做为小 M 的你,必须要按照领导的要求,理解同事怎么记录的,还要完成会议纪要的相关要求。所以,你决定这样做:

1.1 查看同事记录的笔记

打开 X 的笔记,天啊,这是什么:

# 《知识付费到来了》

我要给大家讲讲知识付费。我主要讲4点:

1. 知识从来都是付费的!
2. 我们为学习的消费升级而付费。
3. 谁最适合做知识服务?
4. 我该怎么进入知识付费领域?

## 一、知识从来都是付费的

“知识付费”的本质是知识的转移和传递。

**现在知识存储、传递、获取成本基本为0,这个时候我们在为什么付费?**这是一个很重要的问题,必须要好好思考。

## 二、我们为学习的消费升级而付费

今天,大家都在学习,但是学习的方式有多**不方便**:

- 想学,但不知道学啥;
- 没空学习、没那么多大段时间学;
- 想读的书读不完、读不懂或者一个人读不下去;
- 想听的课太远、太贵、太不好找;
- 好多英文资料特好,但是看不懂;
- 看你们都焦虑我不焦虑我好焦虑啊
-  ……

所以,学习为什么不能更方便、为什么不能更好一些呢?

> 这次的知识付费,是学习的消费升级——老板古少侠

老板的金句已经在这里了,请全体同事认真领会。

为什么一份通常的笔记里面竟然有各种乱码呢?你看,乱七八糟的##>-等等,他为什么要加这么多乱码,不好好地规划好格式呢?

1.2 这里一定有秘密

X 是领导认可的前辈,他一定不会犯低级错误,这里一定有秘密!果然,X 给自己留了一张字条,他是这么说的:

M 你好:
因为家里急事,不得不把剩余的工作交给你,真是不好意思,希望你能见谅。
我记录笔记的方式略有点复杂,看上去可能比较迷惑,为了支持你把工作做好,我提供这份资料给你,你按照我说的,应该能够很快上手。主要有 3 个步骤:
1. 把我给你的资料全选,并复制;

2. 打开地址的链接:https://maxiang.io

3. 把左侧的内容全选,然后粘贴,就会出现下面的效果了!

好了,剩下的就交给你啦,加油。

果然,这里确实有秘密!!认真看看上图,尝试着回答这个问题,看看你能不能说对?请问:

  • #这个井符号表示什么意思?
  • ##这个双井符号表示什么意思?
  • **这个双星符号,前面两个,后面两个,中间的字会变得怎么样?
  • - 这个短线符号,能够生成什么样的内容呢?
  • > 这个尖括号符号,会让后侧的文字变成什么样子呢?

请尝试着回答这个问题。答案在文章的最后,看看你能不能说对?如果你完全理解了这几个符号,那么就把剩余的资料整理完吧!

1.3 看懂了,剩下的任务交给我吧!

原来这么简单,用几个符号就可以把杂乱的文章给架构起来,并且展示的效果还很好啊!

同事 X 的笔记就剩下一部分了,让我来把它整理好吧!笔记内容如下:

# 《知识付费到来了》

我要给大家讲讲知识付费。我主要讲4点:

1. 知识从来都是付费的!
2. 我们为学习的消费升级而付费。
3. 谁最适合做知识服务?
4. 我该怎么进入知识付费领域?

## 一、知识从来都是付费的

“知识付费”的本质是知识的转移和传递。

**现在知识存储、传递、获取成本基本为0,这个时候我们在为什么付费?**这是一个很重要的问题,必须要好好思考。

## 二、我们为学习的消费升级而付费

今天,大家都在学习,但是学习的方式有多**不方便**:

- 想学,但不知道学啥;
- 没空学习、没那么多大段时间学;
- 想读的书读不完、读不懂或者一个人读不下去;
- 想听的课太远、太贵、太不好找;
- 好多英文资料特好,但是看不懂;
- 看你们都焦虑我不焦虑我好焦虑啊
-  ……

所以,学习为什么不能更方便、为什么不能更好一些呢?

> 这次的知识付费,是学习的消费升级——老板古少侠

老板的金句已经在这里了,请全体同事认真领会。


三、谁最适合做知识服务?

有三种人比较适合做知识服务:出版、教育和传媒。

媒体人:罗胖、凯叔、樊登等;
教育人:薛兆丰、宁向东、李笑来、古典;
出版人:本质上,得到199订阅都是出版。

配图的地址是:http://pic.runwith.cc/bitcron/zhishifufei.jpg

老板的金句又来了:

出版脑、内容心、传媒脸、科技大长腿——这就是知识服务者的画像。

四、我该怎么进入知识付费领域?

但如果你理解了:知识付费的本质是知识服务付费,你应该很清晰看到未来的趋势:

学习在未来一定会变得越来越重要、越来越频繁,贯穿一生;
每个学习环节都应该、而且正在重新被设计,达到更好的服务。

如果你从这个角度看,知识服务付费的形式和内涵远远不止今天你看到的各种课,这只是知识付费的初级形态;知识服务这场革命,才刚开始。

老板讲话的原文链接:《如果你看透了“知识付费”这 4 个底层逻辑,其实最好的时代才刚刚开始》https://mp.weixin.qq.com/s/ArvPm9uyrFHE9sFPfeEelA
老板开会的时间:2018年03月29日

X 又留下一张字条:
他是这么说的:

M 你好:
前面的部分你已经搞定了吧?像你这么棒的人,掌握 5 类符号的具体用法根本就不是难事。感谢你的素养,让我心安:因为我没有时间为你写一份教程,只能靠你自己了。
后面的内容我也提供给你了,上面的那一段内容就是,现在老板需要你去把它进行排版。你可以按照下面的 4 个步骤完成整理:
1. 把所有会议纪要的内容全选并复制;
2. 打开地址的链接:https://maxiang.io
3. 把左侧的内容全选,然后粘贴,就会出现下面的效果了!

4. 按照我的方式整理成完整的会议纪要。我给你一份结果的样子,你看看效果。

好了,你试着调整一下看看吧,这里面有几个难点:

  • 如何让字体加粗?
  • 如何插入图片?
  • 如何插入分隔线?
  • 如何加入超链接?

为了帮助你搞定,我提供了一些资料给你:

如果你觉得不够,可以到本文的最后查看其它资料。

1.4 接下来,该庆祝了!

好了,至此关于 Markdown 的基本使用你已经掌握了,当然,那可能只是所有语法的 80%的内容,但是,相信自己的自动学习能力,有了这 80%的积累,后面就都不是问题了。(更何况,我还收集了各种资料供你学习)

看看表,是不是刚刚过去 10 分钟?用 10 分钟掌握一项终身受益的技术,也是够赚的了!

下面,请你用 Markdown 格式书写你的学习感受,争取用到:标题、列表、引用、链接、加粗和目录,试试看!(这也是任务的一部分,尤其是目录。)

2. 问题的答案

所有的问题在这里都有答案。你可以对照查看:

2.1 第 1.2 个任务的答案

  • #这个井符号表示:一级标题
  • ##这个双井符号表示:二级标题
  • **这个双星符号,前面两个,后面两个,中间的字会变得加粗显示
  • - 这个短线符号,能够生成无序列表
  • > 这个尖括号符号,会让后侧的文字变成引用文字

2.2 第 1.3 个任务的答案

# 《知识付费到来了》

我要给大家讲讲知识付费。我主要讲4点:

1. 知识从来都是付费的!
2. 我们为学习的消费升级而付费。
3. 谁最适合做知识服务?
4. 我该怎么进入知识付费领域?

## 一、知识从来都是付费的

“知识付费”的本质是知识的转移和传递。

**现在知识存储、传递、获取成本基本为0,这个时候我们在为什么付费?**这是一个很重要的问题,必须要好好思考。

## 二、我们为学习的消费升级而付费

今天,大家都在学习,但是学习的方式有多**不方便**:

- 想学,但不知道学啥;
- 没空学习、没那么多大段时间学;
- 想读的书读不完、读不懂或者一个人读不下去;
- 想听的课太远、太贵、太不好找;
- 好多英文资料特好,但是看不懂;
- 看你们都焦虑我不焦虑我好焦虑啊
-  ……

所以,学习为什么不能更方便、为什么不能更好一些呢?

> 这次的知识付费,是学习的消费升级——老板古少侠

老板的金句已经在这里了,请全体同事认真领会。


## 三、谁最适合做知识服务?

有三种人比较适合做知识服务:**出版、教育和传媒**。

- 媒体人:罗胖、凯叔、樊登等;
- 教育人:薛兆丰、宁向东、李笑来、古典;
- 出版人:本质上,得到199订阅都是出版。


![](http://pic.runwith.cc/bitcron/zhishifufei.jpg)

老板的金句又来了:

> 出版脑、内容心、传媒脸、科技大长腿——这就是知识服务者的画像。

## 四、我该怎么进入知识付费领域?

但如果你理解了:知识付费的本质是知识服务付费,你应该很清晰看到未来的趋势:

- 学习在未来一定会变得越来越重要、越来越频繁,贯穿一生;
- 每个学习环节都应该、而且正在重新被设计,达到更好的服务。

如果你从这个角度看,知识服务付费的形式和内涵远远不止今天你看到的各种课,这只是知识付费的初级形态;知识服务这场革命,才刚开始。

----

- 老板讲话的原文链接:[《如果你看透了“知识付费”这 4 个底层逻辑,其实最好的时代才刚刚开始》](https://mp.weixin.qq.com/s/ArvPm9uyrFHE9sFPfeEelA)
- 老板开会的时间:2018年03月29日

3. Markdown 的更多用法

你学习了 Markdown 的基本语法,并且尝试将内容排版,这只是刚刚开始,任何一项技术都要和场景组合才能发挥巨大价值。在参考资料的「进阶和高手」部分,我链接了部分高手的用法,你可以移步去看,这里我只是说一下我都用 Markdown 做什么。

我的主要用处有:

  • 写文章:在 MarkEditor 里面用 Markdown 格式书写文章,写完之后可以一键发布到微信公众号,同时还可以形成一个专题网站。
  • 跨平台查看资料:Markdown 是一种构架语言,它可以让你的一篇没有结构的内容形成结构,并且,在所有平台上(Win、Mac、iOS、Android)都是通用的,并且可以保存结构。这样让发布就变得简单很多。

感觉我说的还是技术层面的,算了,直接去看:点这里吧,我要说的都在里面了。

4. 关于 Markdown 书写的基本规范

我在写作的时候,会遵循这样的写作规范:

文档声明

---
date: 2018-03-27 11:58:41
title: 持续高效能个人成长的 8 个层次
tags:
    - '系统思维'
    - '持续高效能成长'
    - '层次'
---

标题使用说明

  • # 用于文章名称,但是由于文章名在声明中声明完成,所以,通常不用#;
  • ## 文章的一级标题,使用数字+点+空格+标题的方式说明,范例:1. 这是一级标题
  • ### 文章的二级标题,使用数字+点+数字+空格+标题的方式说明,范例:1.1 这是二级标题
  • #### 文章的三级标题,使用数字+点+数字+点+数字+空格+标题的方式说明,范例:1.1.1 这是三级标题
  • 文章标题不再使用四级标题,在书写时需要控制层次深度。

有序列表和无序列表使用说明

  • 有序列表用于有明确步骤、有先后、递进关系等步骤说明中;
  • 无序列表用于并列展示要点中;

强调使用说明

  • 强调的使用中,有 4 种主要的方式:加粗(两侧双星号)、行内代码(两侧单引号)、引用(左开口尖括号)、代码块(上下三个单引号)
  • 加粗使用场景:完整句子的突出显示
  • 行内代码使用场景:某个词、某个代码、某个数字的突出显示
  • 引用:提出问题、注明句子、引用名人名言等
  • 代码块:特别强调某一段落的内容

链接使用说明

  • 引用文章时,使用固定话术:具体请参考:[《文章名》](超链接)
  • 如果需要展示链接,使用固定话术:具体请参考链接:[超链接](超链接)

图片使用说明

附.参考资料

新手上路资料:

语法参考手册:

进阶和高手:


ChangeLog

  • 2018-04-04 增加 Markdown 格式使用规范说明 by 易仁永澄
  • 2018-03-31 发布内容 by 易仁永澄