› Daring Fireball: Markdown
› CommonMark
› MacDown Open Source Markdown Editor
› Marked
› GitHub Flavored Markdown
Livid
403.84D
562.95D
V2EX  ›  Markdown

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

  •  
  •   Livid ·
    PRO
    · Apr 23, 2019 · 25832 views
    This topic created in 2753 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
    31 replies  •  2019-04-24 04:11:27 +08:00
    Livid
    Livid
    MOD
    OP
    PRO
    Apr 23, 2019❤️3
    1
    看起来是 2016 年时候的一个巨大的改变:

    https://docs.microsoft.com/en-us/teamblog/introducing-docs-microsoft-com
    Livid
    Livid
    MOD
    OP
    PRO
    Apr 23, 2019
    2
    关于这个新文档系统的文档:

    https://docs.microsoft.com/en-us/contribute/
    Livid
    Livid
    MOD
    OP
    PRO
    Apr 23, 2019
    3
    基础语法部分基于 CommonMark 标准,然后扩展语法部分及渲染是这个:

    https://dotnet.github.io/docfx/
    formulahendry
    formulahendry
    Apr 23, 2019❤️7
    4
    曾经的负责 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
    Livid
    MOD
    OP
    PRO
    Apr 23, 2019
    5
    @formulahendry CommonMark 里没有包括对表格和 code block 的支持实在是个遗憾。
    celeron533
    celeron533
    Apr 23, 2019 via Android
    6
    我记得 markdown 还是支持内嵌 HTML 的
    WildCat
    WildCat
    Apr 23, 2019 via iPhone
    7
    @Livid 不全是,毕竟是创造 Word 的公司 🌚
    airyland
    airyland
    Apr 23, 2019 via iPhone
    8
    腾讯云和阿里云的文档目测也都在 Github 上开源维护了。
    hwdef
    hwdef
    Apr 23, 2019❤️1
    9
    这么看的话,word 和 onenote 到现在都不支持 markdown 还真是怪异,对微软来说加个 markdown 又不会影响什么,也不难。
    Livid
    Livid
    MOD
    OP
    PRO
    Apr 23, 2019❤️1
    10
    @hwdef 喜欢 Markdown 的人最终会用 VS Code 吧。
    Ley
    Ley
    Apr 23, 2019 via Android❤️1
    11
    Azure 这一块 Rest API 文档是 swagger。还一些是 MD,DocFX 转的。然后新的好像开始用 Yaml 了。
    hwdef
    hwdef
    Apr 23, 2019❤️1
    12
    @Livid 说的也对,用 markdown 的大部分是程序员,office 的产品定位可能不是面向程序员的,
    FancyKing
    FancyKing
    Apr 23, 2019 via Android
    13
    我还是希望,OneNote 能加入 markdown (最起码代码能好看点
    passerbytiny
    passerbytiny
    Apr 23, 2019
    14
    完全无纸化,非打印格式,面向开发人员,并且很少协同编辑,这种情况下 Word 对 Markdown 几乎没有优势,而 Word 与 Git 犯冲的劣势就很突出了。

    关键是微软啥时候开放他的 Markdown 引擎。
    matolv
    matolv
    Apr 23, 2019
    15
    Markdown 有 VScode。word 不是给程序员用的,而是给写文章,写书,写论文,写一切非 IT 第二产业文档用的。
    YanSep
    YanSep
    Apr 23, 2019 via Android
    16
    感觉以后 markdown 会很普及,因为这个很方便,而且给人看也很一目了然,但是感觉用 markdown 写一些很正规的文件还是不行的。已经在叫女朋友学习 markdown 了
    yemoluo
    yemoluo
    Apr 23, 2019
    17
    @Livid 我是特例,用了几回 VS Code,最后都换回 Sublime Text 3 了。

    1. 启动速度不能忍
    2. 搜索在左侧小栏目不能忍
    3. 左侧文件列表动不动就被替换不能忍
    Kei
    Kei
    Apr 23, 2019
    18
    然而依旧没有一个成熟的 TypeScript 的 Comment Markdown 生成工具(
    qyc0129
    qyc0129
    Apr 23, 2019
    19
    看来大家追求启动速度是一致的
    CallMeReznov
    CallMeReznov
    Apr 23, 2019
    20
    那他娘的 ONENOTE 为什么还不支持 MD 呢!
    xnplus
    xnplus
    Apr 23, 2019❤️2
    21
    @qyc0129 上岁数了,不马上启动,转眼就忘了
    Mithril
    Mithril
    Apr 23, 2019
    22
    之前用过 Word 的 Markdown 插件,体验并不好。
    Markdown 本身的设计和 Word 就是冲突的,Word 追求的是所见即所得,也就是和你最终打印效果一致。然而 Markdown 是需要标记的,哪怕是 VNote 这类直接预览的编辑器,标记也还是在的。但这些标记不会出现在最终渲染页面里。
    然而 Onenote 不支持 Markdown 实在是说不过去。
    jasonyang9
    jasonyang9
    Apr 23, 2019
    23
    vim,markdown,人脑渲染
    SilencerL
    SilencerL
    Apr 23, 2019
    24
    我就说看文档的时候怎么会有格式渲染的问题...
    kindjeff
    kindjeff
    Apr 23, 2019
    25
    用得最多的 google docs 什么时候能支持 markdown
    waterlaw
    waterlaw
    Apr 23, 2019 via Android
    26
    Python 相关库网站的文档使用 sphinx 生成,markdown 我一般用来写博客, 比较适合独立文章
    nescirem
    nescirem
    Apr 23, 2019
    27
    ”微软整个公司的文档”之类的应该还不至于。虽然用于在线发布的‘网络文档’用 markdown 确实方便,但正式文档的话 Tex 或 Word ?
    morethansean
    morethansean
    Apr 23, 2019 via iPhone
    28
    @GTim
    @qyc0129

    好奇大家都用什么电脑 2333 我觉得启动速度完全不是问题啊,而且我都不关他 _(:з」∠)_
    yemoluo
    yemoluo
    Apr 23, 2019
    29
    @morethansean 命令行 subl . 或者 code .

    我的 code 就是 VS Code,也不能说是启动慢,而是有明显的启动吃力感
    Mayuri
    Mayuri
    Apr 23, 2019 via Android
    30
    OneNote 不支持 真想不通
    lonelygo
    lonelygo
    Apr 24, 2019
    31
    @Mayuri +1,想不通好久了
    About   ·   Help   ·   Advertise   ·   Blog   ·   API   ·   FAQ   ·   Privacy   ·   Solana   ·   3786 Online   Highest 6679   ·     Select Language
    创意工作者们的社区
    World is powered by solitude
    VERSION: 3.9.8.5 · 68ms · UTC 00:49 · PVG 08:49 · LAX 16:49 · JFK 19:49
    ♥ Do have faith in what you're doing.