markdown--一种适合IT人的document editor style

简介:

    之前曾和51CTO的官方人员沟通过,建议在社区全面逐步开始试用markdown来支持博客和论坛等的发布。他们曾承诺会考虑实施。markdown做一种标记语言的应用场景越来越广泛,如今也不是什么新鲜事物了,如果还有一些人不是很熟悉的话,那么正好,请听我一一道来。

     首先让我们从IT类文档编写谈起。抛除正式的行政公文,IT类的文档书写一般比较随意,不像毕业或学术论文,不会刻意去要求格式排版。此外该类文档表现形式通常比较丰富,除了标准文字,图片还会有一系列的图、表等,甚至针对一些软件层说明书和文档还会截取部分只有少部分才能看懂的计算机语言(代码)。在这种情况下,传统的文档编辑如下

1、基于无格式的txt文档 这种文档最大的优点是小巧,便捷,很适合编写一些软件的说明文档如readme。但缺点也是非常明显,无法设置格式,如果要进行排版,非常困难。

wKioL1li8CvSmA5tAAGztPLa1bg455.png-wh_50

这是一份某网站的软件下载说明,从格式上说排版已经相当精美,但是要知道如果要修改这份文档是相当困难的,因为你要考虑对齐的问题,而且最大的问题是这种文档在WEB上没法展示。

2、基于大型办公软件word之流的高级文档。优点不用说了,格式编辑强大,支持功能众多。。。 缺点也是很明显的:排版时间长,WEB展示困难。二进制格式损坏修复困难。。。。

3、类似博客这种UEditor-WEB富文本编辑工具。虽然已经很丰富了,最大的问题还是排版困难,文档移植麻烦


说来说去,那边有没有一种方法能够自动排版,且各处通用呢?


答案自然就是markdown.


那markdown究竟是什么?Markdown是一种轻量级标记语言,它以纯文本形式(易读、易写、易更改)编写文档,并最终以HTML格式发布。也就是说markdown有点类似HTML,也是一种标记语言,也是用纯文本形式编写文档。只不过html文件后缀为.html或.htm,而markdown文件后缀默认为.md

wKioL1li9VDSglIEAAHdqbQhh-4444.png-wh_50

关于markdown的历史请参考文献3


这里要谈一下markdown基本语法和扩展语法

由于Aaron SwartzJohn Gruber两位大神创建了这种语法后,如果没有高级需求,按理说也就足够了(参见文献2)。但是喜爱的用户多了后需求就越来越大了,而且有些设计其实不符合我们的习惯,比如在标准Markdown语法中,要想换行必须在一行的最后加两个空格才行,否则即使你在一行的末尾插入硬回车,这些文本仍然会被合并为一行,这个特性会导致大量非预期的格式化错误。而我们经常会用到表格、脚注、想要自动生成文章目录等,若是涉及代码的技术文章,我们还希望代码支持高亮以提升阅读体验。这就需要用到Markdown的扩展语法了。而其中最流行的当属Github Flavored Markdown 了。参见参考文献4


最后谈一下目前乱像的markdown编辑工具。由于markdown的流行,越来越多的网站都开始支持,如github、Stack Overflow 国内的如简书,作业部落等。而很多编辑器、网络笔记也不甘落后,纷纷推出了自己的插件以便支持。但是markdown的效果大部分是需要解释引擎进行渲染完成(特别是使用了第三方扩展插件)因为解释效果不尽相同,所以导致一份原始的md文件在A工具编写完成后,在B工具导入浏览产生轻者错行错位,重者无法解析排版反而更混乱的怪现象。特别是一些软件作者植入第三方扩展插件,然后重新封装后,虽然利用按钮简化了书写,但是不公布插件列表,不开发源码从而造成文档移植性变差,而且多数编辑工具呈收费的商业软件,而原作者(在世的创始人之一)又极不赞成统一标准,最后导致像当今多种浏览器访问同一个网站显示页面错乱和部分功能不可用等问题

最后,还是让我们感受一下markdown的魅力吧


左边为原始格式,右边为浏览格式

wKioL1li_qDhClRaAAE0lS8H6NQ699.png-wh_50


wKiom1li_qHw1MtGAAFn91OgpNI412.png-wh_50


wKioL1li_qKQvQPuAAJOvt75SIE268.png-wh_50



本文转自 z00w00 51CTO博客,原文链接:http://blog.51cto.com/z00w00/1945826,如需转载请自行联系原作者

相关文章
|
JavaScript 数据库 数据格式
vue2 使用 markdown插件 v-md-editor
vue2 使用 markdown插件 v-md-editor
820 0
|
编译器
在HTML页面中引用Markdown编辑器(Editor.md)
在HTML页面中引用Markdown编辑器(Editor.md)
在HTML页面中引用Markdown编辑器(Editor.md)
|
JavaScript
Vue:MarkDown编辑器mavon-editor
Vue:MarkDown编辑器mavon-editor
730 0
Vue:MarkDown编辑器mavon-editor
|
4月前
|
程序员 Linux iOS开发
一款比Typora更简洁优雅的Markdown编辑器神器(完全开源免费)
一款比Typora更简洁优雅的Markdown编辑器神器(完全开源免费)
215 1
|
4月前
《使用「Markdown」编辑器的那些天 |CSDN编辑器测评》
《使用「Markdown」编辑器的那些天 |CSDN编辑器测评》
51 0
|
4月前
|
机器学习/深度学习 uml
Markdown编辑器用法保存自用
Markdown编辑器用法保存自用
|
1月前
|
存储 安全 数据安全/隐私保护
Django 后端架构开发:富文本编辑器权限管理与 UEditor 、Wiki接入,实现 Markdown 文本编辑器
Django 后端架构开发:富文本编辑器权限管理与 UEditor 、Wiki接入,实现 Markdown 文本编辑器
78 0
|
23小时前
|
JavaScript 前端开发 API
vue3 v-md-editor markdown编辑器(VMdEditor)和预览组件(VMdPreview )的使用
本文介绍了如何在Vue 3项目中使用v-md-editor组件库来创建markdown编辑器和预览组件。文章提供了安装步骤、如何在main.js中进行全局配置、以及如何在页面中使用VMdEditor和VMdPreview组件的示例代码。此外,还提供了一个完整示例的链接,包括编辑器和预览组件的使用效果和代码。
vue3 v-md-editor markdown编辑器(VMdEditor)和预览组件(VMdPreview )的使用
|
3月前
|
存储 移动开发 编解码
基于HTML5开发的Markdown在线编辑器
Markdown是一种轻量级标记语言,以其简洁易读的格式而备受程序员和作者们的青睐。随着互联网的发展,越来越多的在线Markdown编辑器应运而生,为用户提供了更加便捷、高效的写作和编辑环境。本文将探讨基于HTML5开发的Markdown在线编辑器的设计原理、功能特点以及技术优势。
102 4
|
4月前
|
前端开发 C++ iOS开发
几款主流好用的markdown编辑器介绍
几款主流好用的markdown编辑器介绍
312 1