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比较相关推荐

  1. DITA与S1000D的相同与不同

    DITA和S1000D是全球最出名的两种文档规范.这两个规范用于创建.管理和发布各种类型的文档.他们将内容分解成自包含的内容块,每个内容块有自己的类型,然后通过一定的形式将这些内容块组织成文档.他们的 ...

  2. 轻量级DITA - 让公司全员贡献结构化内容

    1. 问题 一个朋友在一个生产型企业的文档团队负责产品文档,他们使用DITA来编写各类文档,比如:公司管理文档.产品介绍.产品使用说明.产品安装手册等. DITA 是基于XML的体系结构,用于编写.制 ...

  3. 如何用memoQ实现DITA本地化?

    1.需要结构化内容 你知道吗?今天互联网上共享的内容的百分之九十是在过去两年中产生的,每天在各种媒体中都会生成的大量内容.不断增长的内容产生了内容结构化的需求.内容不再是生成完整的单元,而是可以通过各 ...

  4. 支持DITA的CCMS、编辑器和工具

    你所在的公司一直使用MS Word.Markdown.Sphinx.FrameMaker这样的工具来写作,最近在考虑转向结构化内容写作和发布,想看看市面上有哪些工具可以使用. 或者, 你们公司已经使用 ...

  5. lisp协议instand_分享|Linux 上 10 个最好的 Markdown 编辑器

    在这篇文章中,我们会点评一些可以在 Linux 上安装使用的最好的 Markdown 编辑器. 你可以在 Linux 平台上找到非常多的 的 Markdown 编辑器,但是在这里我们将尽可能地为您推荐 ...

  6. 【其他】将幕布文章OPML转换为Markdown的方法

    使用幕布可以快速地进行笔记中格式缩进和笔记管理等操作,但是,幕布只提供了Word.PDF.图片.HTML.OPML.思维导图的导出,以下是把幕布的大纲转换成Markdown的方法. 1.先把幕布里的文 ...

  7. 【注意事项】Markdown遇到的小问题

    写博客的目录的时候遇到了一个小问题 在博客三级标题里插入了一个超链接,在正文里看显示格式是正常的 但是文章开头的目录中却出现了显示异常的问题,把Markdown代码直接显示出来了 后来发现是文本里面[ ...

  8. 推荐几个微信Markdown排版工具

    Md2All Markdown Nice WeChat Format 参考链接 原文链接

  9. Markdown入门简介

    参考 http://sspai.com/25137 作者: Te_Lee 文章来源: 少数派 Markdown入门简介(使用工具Haroopad) 一.使用的工具----haroopad(http:/ ...

最新文章

  1. 关于容器的三件事,你知道吗?
  2. 保证计算机网络的稳定运行,厦门大学校园网管理保证网络稳定运行
  3. matlab无刷双馈电机模型搭建,基于MATLAB的无刷双馈电机建模与仿真
  4. 联想高校AI精英挑战赛争霸浙江大学,“管道医生”项目晋级赛摘得桂冠
  5. archive —— 软件历史版本存档及下载、jar 包
  6. MonkeyRunner_API
  7. html transition属性,Transition属性详解
  8. Windows server 2019 安装VPN
  9. pycharm连接云端服务器后实现远程debug调试
  10. jav学习日记:多线程(一)
  11. PDF阅读软件综合评测PDF Expert 、MarginNote、Notability Zotero
  12. [PTA]实验3-1 求一元二次方程的根
  13. hpunix oracle rac,hp unix oracle rac节点一磁盘损坏,节点修复
  14. 在冷风中我凌乱了半小时,只因健康码刷不出来
  15. 一个程序员的自我修养和敬畏之心
  16. 考研计算机专业复试问题汇总——操作系统(王道408)
  17. mjpg-streame
  18. 饿了么大数据平台建设
  19. 用友U8销售退货案例教程
  20. python计算火车的运行时间_python+pandas处理火车换乘数据

热门文章

  1. Linux 查看并杀掉tomcat进程
  2. 【MySQL】C语言连接数据库
  3. uniapp谷歌浏览器dev环境跨域问题解决
  4. Linux 命令行批处理图片,批量去除截图的无用部分
  5. 在酷家乐做面试官的日子
  6. 安装SQL2000 Server的常见问题
  7. 康泰克采样器完整版-Native Instruments Kontakt v6.3.1 WIN/MAC
  8. 《操作系统概念》知识点期末复习整理
  9. SpringBoot 配置返回前端固定格式yyyy-MM-dd HH:mm:ss和接收ISO时间自动转为LocalDateTime
  10. UG NX 12 修剪和延伸