初识 Markdown


开始是使用为知笔记作为平时的记录, 发现为知可以安装插件 「 Editor.md 」使用 Markdown 写作。后来遇到了简书, 简书 Web 也是支持 .md 写作的.

Markdown 是什么

Markdown 是一种轻量级标记语言,创始人为约翰·格鲁伯(John Gruber)。它允许人们「使用易读易写的纯文本格式编写文档,然后转换成有效的XHTML(或者HTML)文档 」—— 维基百科

如果你看不懂以上维基百科对 Markdown 的定义,就当这段掐了没播。约翰·格鲁伯自己对Markdown的描述的重点也在于 「easy-to-read,easy-to-write」。

那么到底 easy 在哪里呢?

虽然称作 「标记语言」,但简单理解 Markdown 就是在文本前增加符号来表示文本格式。你不需要关心标题多大号,列表缩进多少,是否对齐,只要使用了同一种符号标记,Markdown 已经帮你做好了排版。

无图无真相:

Markdown 的好处

  1. 编辑,不用操心排版你只需要把注意力放在内容上。笔者在用 Markdown 之前,打开word 先想想,标题用啥字体呢,几号字呢?不知不觉我的意志力就被消耗了。实际上所谓排版,不就是作者的思路以及内容的层级和结构么,在学会使用 Markdown 之后,几个简单的符号就把这些事儿搞定,样式还特别工整精美。
  2. 修改,不用担心排版想想那些你在同事之间改来改去的 word 文档吧,如果哪位童鞋从外部粘贴了一段带格式的文字,那么你再次打开文档时会发现整个人都不好了:格式被改的乱七八糟,还要重新调整。如果用 Markdown 群组笔记 ,想改哪里改哪里,根本不用担心格式,改完评论里直接 @TA,多轻松!
    一句话来说,Markdown 是用最简单的方式,零排版成本,写出布局工整、阅读舒适的笔记。减少干扰,降低成本,提高效率,不管在什么设备上,看起来都是一个工整的样子。不仅自己阅读爽,分享给朋友也有面儿不是~

那些牛人都在用

阳志平在 2012 年就发博客推崇了一下 Markdown,但那篇文章虽解读深刻,但也略显极客,把Markdown 不仅能排版,能做流程图,还支持数学公式的特性介绍了一遍,连科技论文都要选择 Markdown 都涉猎到了。有兴趣阅读的童鞋可点击这里查看。

很多在线博客和内容社区都提供 Markdown 编辑器,不仅在阅读上带来了舒适、统一、美好的体验,每一个参与写作的人,也能够毫不费力地写出排版整齐的文章来。

如何在为知笔记上创建 Markdown 笔记

为知笔记所有客户端都支持 Markdown ,有两种方法可以创建 Markdown 笔记

  • 第一种:在笔记标题后面加 .md ,编辑并保存后,即可看到渲染后的效果
  • 第二种:在移动端直接创建 Markdown 笔记

编辑完成后,点击 「保存」 按钮,即可看到格式精美的笔记啦!

来个小技巧

不管我再怎么说 Markdown 的语法记忆负担小、简单,在最初你都会有点儿晕。在这里给大家分享个小技巧:

  • 最初只需要记住 # 标题一## 标题二1. 第一点* 这一点,用这几个写写日志、需求文档、小文章,排版上足够了;
  • 逐渐的你发现有些文字需要重点指出,那么还可以使用 **加粗***斜体* 来对文字做重点说明;
  • 如果你是名程序员,那么可以用 `````` 把代码块包起来,渲染后可以关键字高亮,用 > ```可以做引用 ;
  • 学生的话,就去了解一下 LaTex 吧,为知笔记 Markdown 支持 Mathjax 公式渲染哦~

Markdown 格式标记符号说明

1. 标题

在行首插入 1 到 6个#,分别表示标题 1 到标题 6

# 这是标题1
## 这是标题1
###### 这是标题6

点击保存后的效果:

标题1

标题2

标题6

2. 有序列表

在行首增加 1.2.3.,即数字和英文句点, 注意句点与文字中间有空格。不要求数字一定要连续,可以都是1.

1. 有序列表
2. 有序列表
3. 有序列表

点击保存后的效果:

  1. 有序列表
  2. 有序列表
  3. 有序列表

3. 无序列表

在行首增加 * 或 - 与文字之间有空格

* 无序列表
* 无序列表

点击保存后的效果:

  • 无序列表
  • 无序列表

4. 插入图片

可直接粘贴图片,或将图片文件拖动到光标处。

也可以使用标准的Markdown语法,如:

 ![](http://upload-images.jianshu.io/upload_images/4686525-e9947a5b9d18fc24.png?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240)

图片如下所示 :


5. 插入链接

[描述](链接地址) ,例如:[为知笔记](http://www.wiz.cn),注意要使用

保存后的效果为
描述 ,例如:为知笔记,注意要使用英文符号

6. 粗体、斜体、删除线

粗体:在文字前后添加 ** (注意符号与文字间不要有空格)
斜体:在文字前后添加 *
删除线:在文字前后添加 ~~

**粗体**
*斜体*
~~删除线~~
保存后的效果:

粗体
斜体
删除线

7. 引用

在文字前 添加 >

点击保存后的效果:

如果你无法简洁的表达你的想法,那只说明你还不够了解它。 -- 阿尔伯特·爱因斯坦

8. 表格

| 为知笔记|更新 | 版本 |
|------------|-----------|--------|
| WizNote | Markdown| Latest |
点击保存后的效果:

为知笔记 更新 版本
WizNote Markdown Latest

9. 代码

在代码前后增加 三个反单引号:`````` ```

'''
int i = 0; i = 1;
for (int i = 0; i < 100; i++)
{
printf("hello markdown!\n");
}
'''
保存后的效果:

int i = 0; i = 1; 
for (int i = 0; i < 100; i++)
{
      printf("hello markdown!\n");
}

如果需要指定语言, 在开头的`````` 后紧跟具体语言,如: java

10. 目录

在任何你想要展示Markdown 笔记目录的地方,添加 [TOC] , 在阅读模式下,标题1~6样式的内容会被提取出来作为目录,相当于大纲功能。

例如:

[TOC]

点击保存后的效果:

它后面出现的就是目录, 一般我是放到开头, 由于我本文就是采取 MakeDown 写的.所以目录我就截图了。

11. Mathjax 公式

可以创建行内公式,例如:
$\Gamma(n) = (n-1)!\quad\foralln\in\mathbb N$
或者块级公式:
$$ x = \dfrac{-b \pm \sqrt{b^2 - 4ac}}{2a} $$

点击保存后的效果:

12. 流程图

```flow
st=>start: Start
e=>end: End
op1=>operation: My Operation
sub1=>subroutine: My Subroutine
cond=>condition: Yes or No?
io=>inputoutput: catch something...
st->op1->cond
cond(yes)->io->e
cond(no)->sub1(right)->op1

保存后效果:

注意:

  1. 关键词(start、end、operation、subroutine、condition和inputoutput)后的冒号后要紧跟一个空格。
  2. 使用->来连接两个元素,对于condition类型,有yes和no两个分支,如示例中的cond(yes)和cond(no)。

更多关于流程图的语法说明:http://adrai.github.io/flowchart.js/

13. 时序图

```sequence
Alice->Bob: Hello Bob, how are you?
Note right of Bob: Bob thinks
Bob-->Alice: I am good thanks!

保存后效果:

更多关于时序图的语法说明:http://bramp.github.io/js-sequence-diagrams/

14. 脚注

在要添加注释的词语后面增加[^1] ,结尾加入[^1]:空格 注释内容


  1. hi
    效果如下:


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

推荐阅读更多精彩内容

  • 前言: Markdown所具备的诸多优点,致使其在程序员、极客圈、自媒体圈和作家圈非常流行。 markdown优点...
    波段顶底阅读 3,596评论 0 5
  • *一、Markdown是什么 * Markdown是一种轻量级的标记语言,使用的标记语法非常简单,它可以使用纯文本...
    乘风破浪55阅读 910评论 0 2
  • 一、概述# Markdown是一种轻量级的标记语言,他的目标是实现易读易写,一份使用Markdown格式撰写的文件...
    sunnyaxin阅读 1,482评论 2 3
  • 1,学写作。这是一门把话说清楚的技能。 2,学音乐,绘画,英语,书法。不难,艺多不压身,说不定用得上,闲着也是闲着...
    毕钵罗子阅读 123评论 0 1
  • 用了一整天的时间读完整本书,作者带我纵观了亚历山大·洪堡的一生,仿佛是在读一部探险小说,难以自抑阅读过程中的激动心...
    西兰花很好吃阅读 345评论 0 4