Markdown与DITA比较
Markdown是一种轻量级标记语言,创始人为John Gruber。它允许人们使用易读易写的纯文本格式编写文档,然后转换成有效的HTML文档。这种语言吸收了很多在电子邮件中已有的纯文本标记的特性。由于Markdown的轻量化、易读易写特性,并且对于图片,图表、数学式都有支持,许多公司和个人都广泛使用Markdown来撰写帮助文档或是用于博客上发表文章。
DITA 是“Darwin Information Typing Architecture”(达尔文信息类型化体系结构)的缩写。它是基于XML的体系结构,用于编写、制作、交付面向主题的信息类型的内容。DITA的单源内容可以通过不同的方法进行重用,生成不同的交付内容。由于DITA过去用于大型技术手册的编写、管理和交付,它能够满足所有可能呈现给读者的信息发布类型的要求。DITA可用于技术手册、交互培训,教材、标准、报告、商业文档、贸易书籍、旅游和自然指南等书籍的编写。
什么时候应该使用Markdown来写文档,什么时候使用DITA进行结构化写作呢?以下是两种方法的比较:
1. 长处
Markdown
快
易学易上手
与代码系统集成在一起,如Git
方便开发人员协作(使用Git流程)
DITA
内容重用
多产品管理
更广的用户协作
稳定的生态
2. 短处
Markdown
有限的语义表达能力
有限的元数据能力
有限的PDF输出格式控制能力
在生成最终输出前,缺乏强有力的内容验证能力
难以与非技术人员协作
不稳定的生态
DITA
系统实现比较难
工具需求
生态成长缓慢
3. 适用场景
Markdown
单一的产品
单一的读者
单一的语言
单一(有限的)的输出格式
简单的元数据需求
适合开发产品的早期
DITA
内容有许多依赖
多产品共享内容
多种类型的读者
多语言
复杂的输出需求
很多元数据需求
适合成熟的产品
4. 总结
Markdown
Markdown使小型团队能快速投入运行并适合基于云的产品。但随着内容需求随着时间的推移而增长,内容重用和单一来源功能的必要性不容忽视。
适合的场景包括:邮件、博客、写书、笔记、基本的网站内容。
DITA
如果需求是针对一个拥有广泛产品、其变体、快速增长的信息库、多种输出以及对内容重用的强烈需求的大型企业,那么DITA是理想的选择。
替换周期长,一般上了DITA系统,它会为公司提供10年以上的价值。
Markdown与DITA比较相关推荐
- DITA与S1000D的相同与不同
DITA和S1000D是全球最出名的两种文档规范.这两个规范用于创建.管理和发布各种类型的文档.他们将内容分解成自包含的内容块,每个内容块有自己的类型,然后通过一定的形式将这些内容块组织成文档.他们的 ...
- 轻量级DITA - 让公司全员贡献结构化内容
1. 问题 一个朋友在一个生产型企业的文档团队负责产品文档,他们使用DITA来编写各类文档,比如:公司管理文档.产品介绍.产品使用说明.产品安装手册等. DITA 是基于XML的体系结构,用于编写.制 ...
- 如何用memoQ实现DITA本地化?
1.需要结构化内容 你知道吗?今天互联网上共享的内容的百分之九十是在过去两年中产生的,每天在各种媒体中都会生成的大量内容.不断增长的内容产生了内容结构化的需求.内容不再是生成完整的单元,而是可以通过各 ...
- 支持DITA的CCMS、编辑器和工具
你所在的公司一直使用MS Word.Markdown.Sphinx.FrameMaker这样的工具来写作,最近在考虑转向结构化内容写作和发布,想看看市面上有哪些工具可以使用. 或者, 你们公司已经使用 ...
- lisp协议instand_分享|Linux 上 10 个最好的 Markdown 编辑器
在这篇文章中,我们会点评一些可以在 Linux 上安装使用的最好的 Markdown 编辑器. 你可以在 Linux 平台上找到非常多的 的 Markdown 编辑器,但是在这里我们将尽可能地为您推荐 ...
- 【其他】将幕布文章OPML转换为Markdown的方法
使用幕布可以快速地进行笔记中格式缩进和笔记管理等操作,但是,幕布只提供了Word.PDF.图片.HTML.OPML.思维导图的导出,以下是把幕布的大纲转换成Markdown的方法. 1.先把幕布里的文 ...
- 【注意事项】Markdown遇到的小问题
写博客的目录的时候遇到了一个小问题 在博客三级标题里插入了一个超链接,在正文里看显示格式是正常的 但是文章开头的目录中却出现了显示异常的问题,把Markdown代码直接显示出来了 后来发现是文本里面[ ...
- 推荐几个微信Markdown排版工具
Md2All Markdown Nice WeChat Format 参考链接 原文链接
- Markdown入门简介
参考 http://sspai.com/25137 作者: Te_Lee 文章来源: 少数派 Markdown入门简介(使用工具Haroopad) 一.使用的工具----haroopad(http:/ ...
最新文章
- 关于容器的三件事,你知道吗?
- 保证计算机网络的稳定运行,厦门大学校园网管理保证网络稳定运行
- matlab无刷双馈电机模型搭建,基于MATLAB的无刷双馈电机建模与仿真
- 联想高校AI精英挑战赛争霸浙江大学,“管道医生”项目晋级赛摘得桂冠
- archive —— 软件历史版本存档及下载、jar 包
- MonkeyRunner_API
- html transition属性,Transition属性详解
- Windows server 2019 安装VPN
- pycharm连接云端服务器后实现远程debug调试
- jav学习日记:多线程(一)
- PDF阅读软件综合评测PDF Expert 、MarginNote、Notability Zotero
- [PTA]实验3-1 求一元二次方程的根
- hpunix oracle rac,hp unix oracle rac节点一磁盘损坏,节点修复
- 在冷风中我凌乱了半小时,只因健康码刷不出来
- 一个程序员的自我修养和敬畏之心
- 考研计算机专业复试问题汇总——操作系统(王道408)
- mjpg-streame
- 饿了么大数据平台建设
- 用友U8销售退货案例教程
- python计算火车的运行时间_python+pandas处理火车换乘数据
热门文章
- Linux 查看并杀掉tomcat进程
- 【MySQL】C语言连接数据库
- uniapp谷歌浏览器dev环境跨域问题解决
- Linux 命令行批处理图片,批量去除截图的无用部分
- 在酷家乐做面试官的日子
- 安装SQL2000 Server的常见问题
- 康泰克采样器完整版-Native Instruments Kontakt v6.3.1 WIN/MAC
- 《操作系统概念》知识点期末复习整理
- SpringBoot 配置返回前端固定格式yyyy-MM-dd HH:mm:ss和接收ISO时间自动转为LocalDateTime
- UG NX 12 修剪和延伸