关于Markdown入门学习

从事开发有一段时间了,在过程中,阅读了许多的大牛写的博客以及简书文章,也自己写了一些小的博客,认识到用Markdown的作用以及必要性。准备在工作学习之余,写一写自己在过程中遇到的问题,踩过的坑。好记性不如烂笔头,于是乎开始了我的Markdown初步学习之路,为了方便记忆笔记与分享个人心得,边学习边写下这份入门学习笔记。
作为一个纯文本软件的标记语言,Markdown相对来说比其他的更简单,更方便。大部分作家用Word或Pages写作,过去的文档也大都以.doc,.docx格式或是Pages格式储存。还有人为了保证文稿发给谁都能正常打开,会用.txt 格式。

.doc 或 Pages 格式有如下问题:

  • 1 不一定谁都能打开。用 Windows 的人打不开 .pages 文件,用旧版 Word 的人不一定能打开你用新版 Word 写的稿子。

  • 2 对方看到的稿子的样子和你自己看到的可能差别很大。

  • 3 .Office 已经是你电脑上唯一的盗版软件,导致心情不佳。

  • 4 .txt 格式的问题在于没有样式:收到稿子的编辑和设计师可能不知道哪个是小标题,哪里需要斜体,哪里需要加粗。

这就是 Markdown 登场的时候了。

用 Markdown 有如下好处:

  • 兼顾了「什么人都能打开」和「样式」。Markdown 就是纯文本,就是 txt,所以什么人都能打开。而如上所述,你可以用它来标记文本的样式,而且语法非常简单。

  • 由于是纯文本,Markdown 文稿也不会因为未来软件升级而产生不同版本之间的兼容问题,即,不会出现「我这篇稿子是用旧版 Word 写的,你用新版 Word 看可能格式会有点问题」的情况。

  • Markdown 转 HTML 非常方便。HTML 是整个万维网(web)的标记语言,但更重要的是,它也是目前主流电子书格式所用的标记语言。无论是 EPUB, mobi,还是 Kindle 用的专有格式 .azw,都只是把一堆 HTML 文件打包而已。如果你写的是书,用 Markdown 标注格式之后,可以很方便地转为以上格式(当然这个转换工作不需要由你来做);如果你写的是单篇的文章(例如新闻报道或专栏),未来也不排除结集出书的可能。若采用 Markdown,对于日后的文件转换工作也大有裨益。

如何开始用 Markdown?继续用你习惯的写作软件即可。记事本、Word、Pages 都没问题,但请记得存成纯文本格式。就这么简单。

进入学习

—1.标题

这是最为常用的格式,在平时常用的的文本编辑器中大多是这样实现的:输入文本、选中文本、设置标题格式。
而在 Markdown 中,你只需要在文本前面加上 # 即可,同理、你还可以增加二级标题、三级标题、四级标题、五级标题和六级标题,总共六级,只需要增加 # 即可,标题字号相应降低。例如:

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

注:# 和「一级标题」之间建议保留一个字符的空格,这是最标准的 Markdown 写法。
以下是在另一篇博客里面看到的手写图片,我将其引用到本文中,方便参考学习:

手写纯文本案例图片

—2.列表

书写过程中,列表格式经常也会用到,在 Markdown 中,你只需要在文字前面加上 - 就可以了,例如:

  • 文本1
  • 文本2
  • 文本3

如果你希望有序列表,
也可以在文字前面加上 1. 2. 3. 就可以了,例如:

  1. 文本1
  2. 文本2
  3. 文本3

注:-、1.和文本之间要保留一个字符的空格。
以下为列表文本示例截图:

文本示例图片

—3.链接和图片

在Markdown中,如果要插入网址链接,方法是[显示文本](链接地址),例如:

[简书](http://www.jianshu.com)

如果,你需要插入图片,只需要使用如下格式:![](图片链接地址)就好,例如:

![示例引用图片](https://timgsa.baidu.com/timg?image&quality=80&size=b9999_10000&sec=1493790038939&di=093ecce4c762a67c9923f58be46d9892&imgtype=0&src=http%3A%2F%2Fi1.bbs.fd.zol-img.com.cn%2Ft_s800x5000%2Fg4%2FM05%2F00%2F06%2FCg-4WlCSm9WIK8ikAAC5JXZ-t3QAAABhgLS53QAALk9847.jpg)

如图:


Paste_Image.png

—4.名言引用

如果在写作过程中,我们需要引用别人的话或者说名人名言,在Markdown中,在引用文字之前加上>即可,格式如下:

> 世间哪得双全法,不负如来不负卿。
> 人生若只如初见,何事秋风悲画扇。等闲变却故人心,却道故人心易变。

当然,>与引用文本之间有一个空格符。
显示结果如下:

世间哪得双全法,不负如来不负卿
人生若只如初见,何事秋风悲画扇。等闲变却故人心,却道故人心易变。

— 5. 文字格式

目前我所掌握的,在Markdown中一般采用粗体和斜体两种方式:

  • 用两个*包含一段文本就是粗体文字;
  • 用一个*包含的一段文字就是斜体文字。

文本示例:

**世间哪得双全法,不负如来不负卿。**
*人生若只如初见,何事秋风悲画扇。等闲变却故人心,却道故人心易变。*

效果如下:

世间哪得双全法,不负如来不负卿。
人生若只如初见,何事秋风悲画扇。等闲变却故人心,却道故人心易变。

— 6. 代码展示

如果我们在编写过程中,需要引用我们项目中所用代码,

  • 如果只有一段,不换行,可以用`语句包起来;
  • 如果引用为多行,可以将```加在代码段的首行和末行。

示例如下:

 `hello world`
  ```
  这是第一段代码
  这是第二段代码
  这是第三段代码 
  ```

— 7. 关于颜色

因为关于颜色方面本人不经常用,毕竟文章重点不在于颜色而是内容,所以,之前第一次写这篇文章的时候并没有去看颜色的使用方法,后面写东西的时候恰巧遇到了,就贴过来,如果有需要可以看看:

<font face="黑体">这就是黑体字</font>

<font face="微软雅黑">这是微软雅黑</font>

<font face="STCAIYUN">然后是华文彩云</font>

<font color=#0099ff size=7 face="黑体">color=#0099ff size=72 face="黑体"</font>

<font color=#00ffff size=72>color=#00ffff</font>

<font color=gray size=72>color=gray</font>

效果如下:

文字颜色效果图

Size:规定文本的尺寸大小。可能的值:从 1 到 7 的数字。浏览器默认值是 3。
亲测简书不支持此格式字体,如果有需要,参照博客: CSDN-markdown编辑器语法——字体、字号与颜色

总结:

以上6种Markdown常用语法,基本囊括了开发人员在书写笔记及博客的所有所需要的方法内容,因为本人也是参考大牛之前的博客以及文章边学边写,作为学习笔记之用,如果有什么不足之处,还望各位指出,谢谢。

更多关于Markdown其他语法,参见:Markdown语法说明

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念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

推荐阅读更多精彩内容

  • 原作者:http://www.jianshu.com/p/1e402922ee32/ 导语: Markdown 是...
    代码移动工程师阅读 1,016评论 0 3
  • 导语: Markdown是一种轻量级的「标记语言」,它的优点很多,目前也被越来越多的写作爱好者,撰稿者广泛使用。看...
    福哥_阅读 618评论 0 5
  • 导语: Markdown 是一种轻量级的「标记语言」,它的优点很多,目前也被越来越多的写作爱好者,撰稿者广泛使用。...
    葛朋1990阅读 482评论 0 0
  • 转载文章,重新排版,仅用于个人查阅和学习目的。 原文地址:http://www.jianshu.com/p/1e4...
    Jayden_Cao阅读 190评论 0 2
  • 来日并不方长 王海芳 一天天的流水样的日子过去了,看似什么都没变,但是心里又知道时间很仓促,飞快的在我手里流失,仔...
    王海芳阅读 225评论 0 0