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

[Livid]

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

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

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

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

[Livid]

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

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

[Livid]

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

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

[Livid]

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

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

[formulahendry]

曾经的负责 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]

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

[celeron533]

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

[WildCat]

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

[airyland]

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

[hwdef]

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

[Livid]

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

[Ley]

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

[hwdef]

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

[FancyKing]

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

[passerbytiny]

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

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

[matolv]

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

[Flobit]

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

[GTim]

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

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

[Kei]

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

[qyc0129]

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

[CallMeReznov]

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

[xunandotme]

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

[Mithril]

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

[jasonyang9]

vim，markdown，人脑渲染

[SilencerL]

我就说看文档的时候怎么会有格式渲染的问题...

[kindjeff]

用得最多的 google docs 什么时候能支持 markdown

[waterlaw]

Python 相关库网站的文档使用 sphinx 生成，markdown 我一般用来写博客， 比较适合独立文章

[nescirem]

”微软整个公司的文档”之类的应该还不至于。虽然用于在线发布的‘网络文档’用 markdown 确实方便，但正式文档的话 Tex 或 Word ？

[morethansean]

@GTim
@qyc0129

好奇大家都用什么电脑 2333 我觉得启动速度完全不是问题啊，而且我都不关他 _(:з」∠)_

[GTim]

@morethansean 命令行 subl . 或者 code .

我的 code 就是 VS Code，也不能说是启动慢，而是有明显的启动吃力感

[Mayuri]

OneNote 不支持 真想不通

[lonelygo]

@Mayuri +1，想不通好久了