Markdown——入门指南

作者: Te_Lee | 来源:发表于2014-04-17 21:14 被阅读913377次

    转载请注明原作者,如果你觉得这篇文章对你有帮助或启发,也可以来请我喝咖啡

    导语:

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

    [Ulysses for Mac](http://www.ulyssesapp.com)[Ulysses for Mac](http://www.ulyssesapp.com)

    一,认识 Markdown

    在刚才的导语里提到,Markdown 是一种用来写作的轻量级「标记语言」,它用简洁的语法代替排版,而不像一般我们用的字处理软件 WordPages 有大量的排版、字体设置。它使我们专心于码字,用「标记」语法,来代替常见的排版格式。例如此文从内容到格式,甚至插图,键盘就可以通通搞定了。目前来看,支持 Markdown 语法的编辑器有很多,包括很多网站(例如简书)也支持了 Markdown 的文字录入。Markdown 从写作到完成,导出格式随心所欲,你可以导出 HTML 格式的文件用来网站发布,也可以十分方便的导出 PDF 格式,这种格式写出的简历更能得到 HR 的好感。甚至可以利用 CloudApp 这种云服务工具直接上传至网页用来分享你的文章,全球最大的轻博客平台 Tumblr,也支持 Mou 这类 Markdown 工具的直接上传。

    Markdown 官方文档

    这里可以看到官方的 Markdown 语法规则文档,当然,后文我也会用自己的方式阐述这些语法的具体用法

    使用 Markdown 的优点

    • 专注你的文字内容而不是排版样式,安心写作。
    • 轻松的导出 HTML、PDF 和本身的 .md 文件。
    • 纯文本内容,兼容所有的文本编辑器与字处理软件。
    • 随时修改你的文章版本,不必像字处理软件生成若干文件版本导致混乱。
    • 可读、直观、学习成本低。

    使用 Markdown 的误区

    *We believe that writing is about content, about what you want to say – not about fancy formatting. *

    我们坚信写作写的是内容,所思所想,而不是花样格式。
    Ulysses for Mac

    • Markdown 旨在简洁、高效,也由于 Markdown 的易读易写,人们用不同的编程语言实现了多个版本的解析器和生成器,这就导致了目前不同的 Markdown 工具集成了不同的功能(基础功能大致相同),例如流程图与时序图,复杂表格与复杂公式的呈现,虽然功能的丰富并没有什么本质的缺点,但终归有些背离初衷,何况在编写的过程中很费神,不如使用专业的工具撰写来的更有效率,所以如果你需实现复杂功能,专业的图形界面工具会更加方便。当然,如果你对折腾这些不同客户端对 Markdown 的定制所带来高阶功能感到愉悦的话,那也是无可厚非的。
    [flowchart.js on Github(使用 Markdown 绘制流程图)](https://github.com/adrai/flowchart.js)[flowchart.js on Github(使用 Markdown 绘制流程图)](https://github.com/adrai/flowchart.js)

    我该用什么工具?

    Mou for MacMou for Mac
    • 在 Mac OS X 上,我强烈建议你用 Mou 这款免费且十分好用的 Markdown 编辑器,它支持实时预览,既左边是你编辑 Markdown 语言,右边会实时的生成预览效果。不仅如此,Mou 还有一些有趣的偏好设置(Preference),例如主题(Themes)与样式(CSS),它们可以配置出定制化的文本编辑效果与导出效果,如果你对自带的主题与样式不满意还可以到 GitHub 上搜索其它爱好者为 Mou 编写的更多主题样式,导入的方式可以在偏好设置的 Themes 或 CSS 选项中 选择 reload。
    Mou 的编写与预览窗口Mou 的编写与预览窗口

    如果你从事文字工作,我强烈建议你购买 Ulysses for Mac,这款软件入围了苹果 Mac App Store 的 The Best of 2013。它支持更多的写作格式、多文档的支持。Mou,iA writer 这些软件都是基于单文档的管理方式,而 Ulysses 支持 Folder、Filter 的管理,一个 Folder 里面可以创建多个 Sheet,Sheet 之间也可以进行 Combine 处理。

    Mac 上一些 Markdown 编辑器Mac 上一些 Markdown 编辑器
    • 由于笔者很少接触 Windows,Windows 下的 Markdown 没有过多涉猎,经朋友介绍,有两款还算不错,一款叫做 MarkdownPad ,另一款叫做 MarkPad

    • iOS 端很多 app 早已经支持了 Markdown 录入,例如 Drafts,Day One,iA writer 等,另外 Ulysses for iPad 现在已经上架,可以说是 iOS 平台最好的编辑器了。

    • 在 Web端,我强烈推荐简书这款产品,上面有无数热爱文字的人在不停的创造,分享。在 Web 端使用 Markdown 没有比简书更舒服的地方了,同样支持左右两栏的实时预览,字体优雅,简洁。

    简书的编辑预览模式简书的编辑预览模式

    二,Markdown 语法的简要规则

    标题

    标题标题

    标题是每篇文章都需要也是最常用的格式,在 Markdown 中,如果一段文字被定义为标题,只要在这段文字前加 # 号即可。

    # 一级标题

    ## 二级标题

    ### 三级标题

    以此类推,总共六级标题,建议在井号后加一个空格,这是最标准的 Markdown 语法。

    列表

    熟悉 HTML 的同学肯定知道有序列表与无序列表的区别,在 Markdown 下,列表的显示只需要在文字前加上 -* 即可变为无序列表,有序列表则直接在文字前加1. 2. 3. 符号要和文字之间加上一个字符的空格。

    无序列表与有序列表无序列表与有序列表

    引用

    如果你需要引用一小段别处的句子,那么就要用引用的格式。

    例如这样

    只需要在文本前加入 > 这种尖括号(大于号)即可

    引用引用

    图片与链接

    插入链接与插入图片的语法很像,区别在一个 !

    图片为:![]()

    链接为:[]()

    插入图片的地址需要图床,这里推荐围脖图床修复计划CloudApp 的服务,生成URL地址即可。

    URL 与图片URL 与图片

    粗体与斜体

    Markdown 的粗体和斜体也非常简单,用两个 * 包含一段文本就是粗体的语法,用一个 * 包含一段文本就是斜体的语法。

    例如:这里是粗体 这里是斜体

    表格

    表格是我觉得 Markdown 比较累人的地方,例子如下:

    | Tables        | Are           | Cool  |
    | ------------- |:-------------:| -----:|
    | col 3 is      | right-aligned | $1600 |
    | col 2 is      | centered      |   $12 |
    | zebra stripes | are neat      |    $1 |
    

    这种语法生成的表格如下:

    Tables Are Cool
    col 3 is right-aligned $1600
    col 2 is centered $12
    zebra stripes are neat $1

    代码框

    如果你是个程序猿,需要在文章里优雅的引用代码框,在 Markdown下实现也非常简单,只需要用两个 ` 把中间的代码包裹起来。图例:

    使用 tab 键即可缩进。

    分割线

    分割线的语法只需要三个 * 号,例如:


    到这里,Markdown 的基本语法在日常的使用中基本就没什么大问题了,只要多加练习,配合好用的工具,写起东西来肯定会行云流水。更多的语法规则,其实 Mou 的 Help 文档栗子很好,当你第一次使用 Mou 时,就会显示该文档。可以用来对用的查找和学习。

    三,相关推荐:

    工具

    图床工具用来上传图片获取 URL 地址

    在线好用的Markdown工具,为印象笔记而生

    相关文章阅读


    本文首发在少数派转载请注明原作者,如果你觉得这篇文章对你有帮助或启发,也可以来请我喝咖啡
    利益相关:本篇文章所有涉及到的软件均为笔者日常所用工具,无任何广告费用。

    相关文章

      网友评论

      • Java耕耘者:你好!我们是Java耕耘者专注于程序员Java开发公众号“Java这点事”。我们很赞赏你的文章,希望能获得转载授权。授权后,你的文章将会在公众号“Java这点事”、发布。我们会注明来源和作者姓名。
        非常感谢~~~
      • 18cec14625e7:typora最好
      • 金融民工小曾:今天花了点时间研究了下,其实对于新手来说,找一个好用的markdown工具,基本不需要关心语法,5分钟即可上手使用,写了篇教程《5分钟轻松上手MARKDOWN》 https://www.jianshu.com/p/6202556ffb35 大家可参考
        金融民工小曾:要了解更多语法,可以参考其他详细教程
      • d8aab757a0f9:```c
        代码
        ```

        ```java
        代码
        ```
        ```
        代码
        ```
        ```go
        代码
        ```
        建议这样用
      • 0c45406e8da8:文章很棒。我们侠课岛正好在找远程录制课程视频或图文教程的朋友,我们会给到课程的需求大纲,每一节课程需要你来详细展开写一些代码举例和讲解清楚,对经验积累和创新能力有一定的要求。有兴趣联系我,微信:zhimadt
      • 颜家大少:要想把markdown转换到公众号,知乎,博客等各平台,就用Md2All,一键排版,一键复制,http://md.aclickall.com
      • 0c45406e8da8:文章内容挺不错的。我们侠课岛也正在找合作伙伴远程录制课程视频或图文教程,我们会给到课程的需求大纲,每一节课程需要你来详细展开写一些代码举例和讲解清楚,对经验积累和创新能力有一定的要求,有兴趣可以联系我。加我微信:zhimadt
      • 梅廷芳先生:太实用
      • d9dc99ee75ed:简书markdown怎么实现实时预览?
      • 末日携手的半阳:总结的很全面,谢谢分享👏
      • Blutter:一直在用,不错的
      • 4fea393dc5d6:###**谢谢,很有收获**
        照着上面的全部学着输入了一遍,然后编辑了一个使用markdown的文版就是这个入门
      • 1d24f2b2e34f:支持一个,相当于官网的说明之外补充了
      • bwzhny:非常赞
      • f91d243927f3:可以用cmd markdown,不用学也可以写markdown,上面有像word一样的图标
      • 2fce709f1695:谢谢分享!
      • 如鱼饮酒:谢谢分享!
      • 473adb896067:文末配上我这篇专门提高阅读体验的文章更佳
        请指正http://www.jianshu.com/p/3904d4306464
        2fce709f1695:@绒绿酱 谢谢分享!
      • 巭番茄:谢谢你的指导,很给力。
      • 强子ly:真nb
      • flyfish712:请问为什么我登陆简书,写文章的时候没有出现Markdown这个编辑器画面呢?
      • 大梦斋:很实用,已经收藏。谢谢分享。
      • SnowDragonYY:楼主您好,请问,文章里面的代码块,如何添加行号啊?
      • 斗米半升:我去,三年前的文章了,认真学习了一下,怕过一段时间不用又忘了,所以自己写了一个贴子,加深印象:grin:
      • live777:“ 轻松的导出 HTML、PDF 和本身的 .md 文件。”
        请问怎么导出 PDF 和本身的 .md 文件?
      • d646d90b6359:不错不错,收藏了。

        推荐下,源码圈 300 胖友的书单整理:http://t.cn/R0Uflld


        aec055493426:写的不错,谢谢博主;已收藏~
      • omni_Hsin:你这篇文章我才也是markdown写的吧,图片下面那个标注和横线是怎么弄出来的?多谢
      • 44bd3fdd6c29:图片下面的文字和横线是怎么弄的?
      • 慢慢慢慢热:想问下 如果内容的第一个字符和前面的标签一致的话该怎么显示呢?
        比如,>是引用,如果引用的内容里第一个字刚好是>,那要怎么才能显示这个>
      • 5421a329aae7:图片加文字链接格式为 [![]()]()
      • 5421a329aae7: Mou 不支持sierra,官方上也给出说明了
      • yycgis:请教下,图床怎么用?上传成功后,访问连接,为啥老是404?
        Not Found

        The requested URL /images/default_.gif was not found on this server.
      • 42b56205e6d2:好文章
        css3制作图形大全:http://t.cn/RKMSgPO
      • 安山1:我不太懂,我在简书,把格式设置成markdown,在里面编辑文字,按照你这样舒服相关字符,可是它没有改变啊,输入什么就是什么啊,是不是我还没领会啊
      • 星光伴我行:挺实用的入门说明,谢谢作者的无私分享👍
      • 一道自媒体平台:我们真诚的邀请您体验一个基于markdowm编辑器开发的个人笔记和在线图书馆,给您提供一个美好的笔记记录和学习体验。地址:https://www.markbj.com/
      • 85017b08124b: 这篇文章写的有些尴尬,要说专业吧.楼上有大神代码框写简略了.要是入门吧,我气不打一处
        来:
        1.我是纯新手,无序列表那里我怎么也打不出来.
        2.在粗体与斜体那里,博主仅仅是非常简单的说了粗体用两个**,斜体用一个*,然而我试了半天
        飞还是不行,我把中英标点切换,全半角切换全试了一遍还是不行,就在我绝望的时候,我搜了
        下其他教程,纳尼必须前后都有*才可以,我去,一口老血喷在屏幕上,大兄弟你根本没提啊!!!
        3.我仔仔细细对表格一笔一笔打的,纳尼?不对. 我再对比对比修改修改,纳尼?还是不对???
        算了,反正暂时用不着,以后再说!
        结果我闲着没事看看评论:原生markdown不支持这样的表格吧,扩展的markdown才支持
        我靠大哥你玩我呢!!!!,一口老血喷在屏幕上!
        4.代码框写的太简略,没看懂,上面大神说了.
        5.其实我感觉实用的还有一些,可博主说不会的查Mou吧,我的亲哥,你这可是入门课程,我们真
        不是程序猿啊!!!
        总之坑太多了,对新手太不友好了,在我郁闷的吐血了时候,我把博主的所有文章都看完了,又看了下微博后,我彻底明白了.....
        其实还是有很多优点的,例如超级精美的排版,一看就不是程序猿写的文章,超级精美的介绍,占一半你能相信吗,比教程还要多.等等优点.至少让我愿意花时间来学习第一步了.
        将近三千的关注...估计跟我一开始一样先收藏以后想起来在看吧...
        能看到的新手朋友点个赞吧,也让其他新手少走点坑.
        我还是很爱博主的全都关注了...
        斗米半升:@Te_Lee 我看一次就会了,粗体和斜体,上面写着“包含一段文字” 我就知道两头都要有:smile:
        85017b08124b: @Te_Lee 爱你
        Te_Lee:感谢你码了这么多字。首先,这篇文章是三年前我接触 Markdown 这种写作形式从而对我学习的过程做出总结,然后写出的一篇我认为看过能够「入门」的文章,因为当时能够接触到 Markdown 这种写作形式的人基本比较偏 Geek,所以它整体风格看起来可能对大多数人来说又不是那么「入门」。其次,对于你说的关于「无序列表」的「代码」问题,其实文章里也已经提到了,你看到的目前各种类型的Markdown 编辑器是人们用不同的编程语言实现了多个版本的解析器和生成器,这就导致了目前不同的 Markdown 工具集成了不同的功能,所以用起来在「代码」方面也会有差异。希望能够帮到你,谢谢。:-)
      • 107国道:没有很明白有序列表和无序列表
      • vobear:不错。明天就打算开始写
      • HellPoet:不错的介绍 很有帮助
      • 老余的故事:写的很好,很喜欢~:stuck_out_tongue_winking_eye:
      • 隔壁老C:咨询下,代码段的背景色是怎么调整的呢?看到简书上有些文章中的代码片段的背景色是调整了的。
      • 见闻无限:我就想知道颜色怎么弄
      • JerryCheese:截图用的啥软件?
      • 7ffaf146332f:为何评论不允许markdown
      • 玉玲君:Mou 1.0不是免费的啊,0.8.7beta版本是免费的可是系统版本太高安装不了,郁闷
      • 高高叔叔:本来就想简单写一个简书的,妈的还要学习这个那个的我草的。。
      • 天南隐湘:总结的不错,因为markdown到了简书:relieved:
      • c2230c72f362:不错,学习了
      • hooyaru:谢谢
      • 吴高亮:挺好的;简单的入门;慢慢的深入吧
      • 211863023d89:😲😲😲
      • Clear_in:##在哪可以用这种语法?
      • 60bc611f9695:很优雅的插件
      • 005846b28e0a:可以转载吗?
      • 扣篮的左手:代码段是用三个```包裹吧,看文中说是两个
      • 宋森_8f0b:学习 感谢
      • Clendy:灰常详细的教程!膜拜大神!
      • 不忘初衷8200:你这篇文档是用什么写的?
      • JRG_Orange:学习下用法
      • 酒低三分:简述网页版哪里可以用markdoen的编辑??要插件??
      • _刘小c:收藏!
      • ea2fb2a58f46:謝謝作者,寫得非常詳細!
      • 修得养得梦得过得:简单粗暴,一目了然,32个赞
      • c7346f8f16ec:mac端 个人最喜欢的md书写工具是 Typora
      • simple雨:谢谢楼主分享!
      • keyworldtony:第一次在github上看见.md文件的时候,有点兴奋,后来懒了,现在再看看真的很便捷。
      • 005846b28e0a:有没有进阶教程?
      • 4b902193ee0a:看来office的心里是崩溃的
      • 钰见专栏:原来一直用markdown,中间断了两个月,回头再用已经忘得差不多了,回来重新温习一遍
      • 滥情绝恋:新人刚学习了两天 感觉太好用了 很赞
      • smartphp:好啊
      • NotFunGuy:这么好用的东西,我现在才发现。。。。
      • 巉岩与沙滩:我刚开始使用markdown,先用最简单的功能。现在遇到的障碍是不知道如何插入图片。我用的是markdownpad2免费版(不是专业版),按照您的说明下载了cloudapp,但下载之后注册时遇到了问题,总提示exception of type...,试了很多次也处理不好。不知您有何处理办法?谢谢
        Te_Lee:@巉岩与沙滩 搜索微博图床来用
      • d0e06dadf5ab:我用过sublime
      • 祝融夫人OR:想请教一下,本地写好的MD文件可以直接上传简书么。。。还是要重新copy代码到简书上才能发布本地写好的日记。。。
      • 祝融夫人OR:不知点解,我下载的mou软件,mac上打不开。。。难道系统太高。。。
        还有一个问题请教一下。。。我在mac上使用![icon](http://ww3.sinaimg.cn/large/006y8lVagw1fag19nkc77j31kw23u1kx.jpg =100x100) 缩放图片没有效果。。。不知道啥原因。。。我用的markdown软件写的
      • 青蛙要fly:厉害我的哥
      • ImTudou:不错哦
      • 鱼f:厉害
      • 陆大胖:Mou已经停止维护了,挺可惜的~
      • 闪电代码手:写的很详细,谢谢博主,
      • 一抹淡季:谢谢分享,学习了
      • 疯狂的键盘:mou已经停止开发了。对代码块的支持不好。
      • 醉雨清风:你好 可以转载吗?
      • 醉雨清风:```
        哈哈哈 试试评论
        ```
      • 153c0128abf0:学习了~
      • 若诗倪:学了一早上代码,算是学会了,感谢了~~ :smiley:
      • wangdongxukin61:写的挺好的,学习了。
      • MLjoy_HDU:楼主你好,我想问下你图片下面加注释是怎么弄的
      • aabe3a2fab65:认真用下
      • 7a946bf5d2ca:楼主用过MacDown吗 怎么样 它可以在markdown代码右边实时显示预览效果。
      • 猛马X:没有找到简书文章导出PDF的功能。一键下载所有文章,下载的是html,我有一篇文章的图片直接给裁了一半。
      • Elliot_Alderson:真是感觉不错呢!
      • ZivYan:对我有用

      本文标题:Markdown——入门指南

      本文链接:https://www.haomeiwen.com/subject/wgyltttx.html