貌似微软整个公司的文档现在都在用 Markdown 格式? - V2EX
V2EX = way to explore
V2EX 是一个关于分享和探索的地方
现在注册
已注册用户请  登录
Livid
179.91D
601.82D
V2EX    Markdown

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

  •  
  •   Livid
    PRO
    2019-04-23 06:29:27 +08:00 24904 次点击
    这是一个创建于 2422 天前的主题,其中的信息可能已经有所发展或是发生改变。
    每一个像这样的展示页面:

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

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

    https://github.com/MicrosoftDocs/azure-docs/tree/master/articles/cosmos-db
    31 条回复    2019-04-24 04:11:27 +08:00
    Livid
        1
    Livid  
    MOD
    OP
    PRO
       2019-04-23 06:31:31 +08:00   3
    看起来是 2016 年时候的一个巨大的改变:

    https://docs.microsoft.com/en-us/teamblog/introducing-docs-microsoft-com
    Livid
        2
    Livid  
    MOD
    OP
    PRO
       2019-04-23 06:42:20 +08:00
    关于这个新文档系统的文档:

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

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

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

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

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

    我的 code 就是 VS Code,也不能说是启动慢,而是有明显的启动吃力感
    Mayuri
        30
    Mayuri  
       2019-04-23 15:45:54 +08:00 via Android
    OneNote 不支持 真想不通
    lonelygo
        31
    lonelygo  
       2019-04-24 04:11:27 +08:00
    @Mayuri +1,想不通好久了
    关于     帮助文档     自助推广系统     博客     API     FAQ     Solana     2882 人在线   最高记录 6679       Select Language
    创意工作者们的社区
    World is powered by solitude
    VERSION: 3.9.8.5 38ms UTC 14:09 PVG 22:09 LAX 06:09 JFK 09:09
    Do have faith in what you're doing.
    ubao msn snddm index pchome yahoo rakuten mypaper meadowduck bidyahoo youbao zxmzxm asda bnvcg cvbfg dfscv mmhjk xxddc yybgb zznbn ccubao uaitu acv GXCV ET GDG YH FG BCVB FJFH CBRE CBC GDG ET54 WRWR RWER WREW WRWER RWER SDG EW SF DSFSF fbbs ubao fhd dfg ewr dg df ewwr ewwr et ruyut utut dfg fgd gdfgt etg dfgt dfgd ert4 gd fgg wr 235 wer3 we vsdf sdf gdf ert xcv sdf rwer hfd dfg cvb rwf afb dfh jgh bmn lgh rty gfds cxv xcv xcs vdas fdf fgd cv sdf tert sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf shasha9178 shasha9178 shasha9178 shasha9178 shasha9178 liflif2 liflif2 liflif2 liflif2 liflif2 liblib3 liblib3 liblib3 liblib3 liblib3 zhazha444 zhazha444 zhazha444 zhazha444 zhazha444 dende5 dende denden denden2 denden21 fenfen9 fenf619 fen619 fenfe9 fe619 sdf sdf sdf sdf sdf zhazh90 zhazh0 zhaa50 zha90 zh590 zho zhoz zhozh zhozho zhozho2 lislis lls95 lili95 lils5 liss9 sdf0ty987 sdft876 sdft9876 sdf09876 sd0t9876 sdf0ty98 sdf0976 sdf0ty986 sdf0ty96 sdf0t76 sdf0876 df0ty98 sf0t876 sd0ty76 sdy76 sdf76 sdf0t76 sdf0ty9 sdf0ty98 sdf0ty987 sdf0ty98 sdf6676 sdf876 sd876 sd876 sdf6 sdf6 sdf9876 sdf0t sdf06 sdf0ty9776 sdf0ty9776 sdf0ty76 sdf8876 sdf0t sd6 sdf06 s688876 sd688 sdf86