美文网首页有用PMskill
使用markdown写文档一个月心得

使用markdown写文档一个月心得

作者: a5768599b114 | 来源:发表于2014-04-09 16:57 被阅读20170次

    以前写文本文档, 一般有两个情况一种是以富文本的形式来写一些图文并茂,表现形式比较全面的大篇幅文章。 其次就是用VIM 、sublime text2、notepad++来来写一些纯文本。对于后者我没有任何怨言, linux下面我是vim控。 几乎所有的配置文件都是文本, 但在linux环境下如果给我doc我估计要杀了他。linux的黑白终端,是vim肥沃的土壤。 但很多情况下, 别人给我文档我都是在windows word中查看, 然后一点一点的复制过去, 这就必须的让我抛不开鼠标的标记。这样下来vim和notepad有什么有事可谈? 信手拈来的快捷键也无用武之地。 所以这是我喜欢markdown的一个理由。

    但仅仅这样不足以说明markdown的诱惑之处。

    我们可以设想一下, 当你的word文档需要发布的时候, 你是考虑通过doc发布还是pdf发布, 还是其他主流的mht? 不管怎样发布首先你都要有word等富文本编辑器。然后各种转换工具, doctopdf, pdftodoc等等, 而且这种工具几乎都是在使用的时候才想起来安装一个, 用了一次之后甚至几个月都不会再用一次。

    浪费精力 浪费时间 浪费资源。

    而这些markdown全都给你解决了, 一般markdown编辑器都有转成html的功能, 直接发给他们一个html网页文档, 一样可以给客户很好的展现。当然如果你想发布文档, 可以用pandoc转换下, N多格式总有一个是你想要的。 而我发布一般都是markdown 文件, 这样得到的人就能好好了解md的语法格式, 如果喜欢最好,可以很方便的阅读了,增长md语法知识, 如果不喜欢也没关系, 精简的语法不会影响内容的阅读。

    还有一个可能会被认为缺点的优势, 纯文本格式,相比HTML超文本不同的是markdown语法简单多了, 相同的是图片都是需要外链的。有人说这个很麻烦,还要找图床, 每次上传拷贝连接地址太麻烦 而我觉得这个恰好让我们的文章的图片都集中化了, 拷贝链接地址不是理由, 要知道用富文本可是要点N多次鼠标的, 同样是编辑我现在我可是手放键盘标准姿势眼神平顺一心一意在写。 我这个人是键盘控, 所以喜欢了vim等工具,只要有快捷键绝不用鼠标。
    所以我总结了markdown的优缺点:

    优点

    • 语法简洁
    • 简单、轻量级
    • 标签有行业标准
    • 应用广泛([GitHub][2]、[Reddit][3]、[StackOverFlow][4]、[JianShu][5])
    • 相应的工具支持很好。(pandoc、sublime Text 2)

    缺点

    • 表格实现需要html代码([解决方案][1])
    • pandoc没有图形界面

    所以写文章极力推荐使用markdown撰写的, 这也是喜欢简书网站的原因之一。

    对于我的博客内容全是markdown渲染的, 这就是答案。
    如果你也喜欢, 可以下载我的mdown文件。[下载][6]

    [0]:http://jackeygaoblog.qiniudn.com/markdown_doc.jpg)
    [1]:http://www.ituring.com.cn/article/3452
    [2]:https://github.com/guoyunsky/Markdown-Chinese-Demo/blob/master/README.md
    [3]:http://www.reddit.com
    [4]:http://stackoverflow.com/
    [5]:http://jianshu.io
    [6]:http://www.jackeygao.com/download/64/

    相关文章

      网友评论

        本文标题:使用markdown写文档一个月心得

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