在Azure DevOps的工作项中使用markdown

Contents

• 1. 概述
• 2. 操作方法
  • 2.1 手动更新工作项
  • 2.2 使用接口更新工作项
• 3. 备注

1. 概述

Markdown 是一种轻量级的 标记语言(markup language)，用于快速格式化纯文本，使其转换为结构化的 HTML 或其他富文本格式。它的设计初衷是让写作更简单、更易读，同时能轻松转换为网页内容。

在Azure DevOps中，工作项作为一种表单形式的内容管理工具，记录了大量开发过程数据。其中富文本使用图文并茂的方式存储了类似需求说明、重现过程等内容。
在之前的版本(默认设置)中，使用HTML作为富文本的语言载体，渲染富文本中的图片、表格、列表等复杂的展现形式。由于HTML是一种标记语言，在编写、识别和兼容性等方面，相对比较复杂；非技术开发人员短时间内很难掌握HTML语言。

与此对照，markdown语言具有明显的优势，它容易读写，它专注于内容、而非样式；它具有更好的兼容性，在第三方系统中能够非车容易被识别；它很容易形成版本管理、用于比对前后的差异。

由于存在这些明显的优势，在新版的Azure DevOps中，用户可以选择markdown作为富文本的记录方式；本文将为你介绍如何使用这个新的功能。

2. 操作方法

2.1 手动更新工作项

• 默认情况下，在Azure DevOps中的所有富文本字段，都用HTML类型的语言存储；例如，下图中的需求工作项的描述字段，就是使用HTML存储，你可以使用HTML的编辑器编辑所见即所得的内容。
  在最新版本的Azure DevOps中，在富文本框的下方，你可以看到将HTML转换为Markdown语言的按钮，点