貌似微软整个公司的文档现在都在用 Markdown 格式？

› MacDown Open Source Markdown Editor

This topic created in 2610 days ago, the information mentioned may be changed or developed.

每一个像这样的展示页面：

https://docs.microsoft.com/en-us/azure/cosmos-db/

背后都可以找到在 GitHub 上的 Markdown 源代码：

https://github.com/MicrosoftDocs/azure-docs/tree/master/articles/cosmos-db

Markdown

GitHub

貌似

文档

31 replies • 2019-04-24 04:11:27 +08:00

Livid

MOD

PRO

Apr 23, 2019

看起来是 2016 年时候的一个巨大的改变：

https://docs.microsoft.com/en-us/teamblog/introducing-docs-microsoft-com

Livid

MOD

PRO

Apr 23, 2019

关于这个新文档系统的文档：

https://docs.microsoft.com/en-us/contribute/

Livid

MOD

PRO

Apr 23, 2019

基础语法部分基于 CommonMark 标准，然后扩展语法部分及渲染是这个：

https://dotnet.github.io/docfx/

formulahendry

Apr 23, 2019

曾经的负责 docs 的开发部门做过。

应该说，现在大部分手写的文档用的是 Markdown，但不全是。

对于从代码自动生成的文档，比如 https://docs.microsoft.com/en-us/cli/azure/reference-index?view=azure-cli-latest ，一般是 Markdown 或者 YAML： https://github.com/MicrosoftDocs/azure-docs-cli/tree/master/2017-03-09-profile/docs-ref-autogen

Livid

MOD

PRO

Apr 23, 2019

@formulahendry CommonMark 里没有包括对表格和 code block 的支持实在是个遗憾。

celeron533

Apr 23, 2019 via Android

我记得 markdown 还是支持内嵌 HTML 的

WildCat

Apr 23, 2019 via iPhone

@Livid 不全是，毕竟是创造 Word 的公司 🌚

airyland

Apr 23, 2019 via iPhone

腾讯云和阿里云的文档目测也都在 Github 上开源维护了。

hwdef

Apr 23, 2019

这么看的话，word 和 onenote 到现在都不支持 markdown 还真是怪异，对微软来说加个 markdown 又不会影响什么，也不难。

Livid

MOD

PRO

Apr 23, 2019

@hwdef 喜欢 Markdown 的人最终会用 VS Code 吧。

Ley

Apr 23, 2019 via Android

Azure 这一块 Rest API 文档是 swagger。还一些是 MD，DocFX 转的。然后新的好像开始用 Yaml 了。

hwdef

Apr 23, 2019

@Livid 说的也对，用 markdown 的大部分是程序员，office 的产品定位可能不是面向程序员的，

FancyKing

Apr 23, 2019 via Android

我还是希望，OneNote 能加入 markdown （最起码代码能好看点

passerbytiny

Apr 23, 2019

完全无纸化，非打印格式，面向开发人员，并且很少协同编辑，这种情况下 Word 对 Markdown 几乎没有优势，而 Word 与 Git 犯冲的劣势就很突出了。

关键是微软啥时候开放他的 Markdown 引擎。

matolv

Apr 23, 2019

Markdown 有 VScode。word 不是给程序员用的，而是给写文章，写书，写论文，写一切非 IT 第二产业文档用的。

YanSep

Apr 23, 2019 via Android

感觉以后 markdown 会很普及，因为这个很方便，而且给人看也很一目了然，但是感觉用 markdown 写一些很正规的文件还是不行的。已经在叫女朋友学习 markdown 了

yemoluo

Apr 23, 2019

@Livid 我是特例，用了几回 VS Code，最后都换回 Sublime Text 3 了。

1. 启动速度不能忍
2. 搜索在左侧小栏目不能忍
3. 左侧文件列表动不动就被替换不能忍

Kei

Apr 23, 2019

然而依旧没有一个成熟的 TypeScript 的 Comment Markdown 生成工具（

qyc0129

Apr 23, 2019

看来大家追求启动速度是一致的

CallMeReznov

Apr 23, 2019

那他娘的 ONENOTE 为什么还不支持 MD 呢!

xnplus

Apr 23, 2019

@qyc0129 上岁数了，不马上启动，转眼就忘了

Mithril

Apr 23, 2019

之前用过 Word 的 Markdown 插件，体验并不好。
Markdown 本身的设计和 Word 就是冲突的，Word 追求的是所见即所得，也就是和你最终打印效果一致。然而 Markdown 是需要标记的，哪怕是 VNote 这类直接预览的编辑器，标记也还是在的。但这些标记不会出现在最终渲染页面里。
然而 Onenote 不支持 Markdown 实在是说不过去。