首页   注册   登录
V2EX = way to explore
V2EX 是一个关于分享和探索的地方
现在注册
已注册用户请  登录
Daring Fireball: Markdown
CommonMark
Mou Markdown Editor for OS X
MacDown Open Source Markdown Editor
Marked
GitHub Flavored Markdown
V2EX  ›  Markdown

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

  •  
  •   Livid · 229 天前 · 18544 次点击
    这是一个创建于 229 天前的主题,其中的信息可能已经有所发展或是发生改变。
    每一个像这样的展示页面:

    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
        1
    Livid   V2EX Moderator   229 天前   ♥ 3
    看起来是 2016 年时候的一个巨大的改变:

    https://docs.microsoft.com/en-us/teamblog/introducing-docs-microsoft-com
        2
    Livid   V2EX Moderator   229 天前
    关于这个新文档系统的文档:

    https://docs.microsoft.com/en-us/contribute/
        3
    Livid   V2EX Moderator   229 天前
    基础语法部分基于 CommonMark 标准,然后扩展语法部分及渲染是这个:

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

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

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

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

    我的 code 就是 VS Code,也不能说是启动慢,而是有明显的启动吃力感
        30
    Mayuri   229 天前 via Android
    OneNote 不支持 真想不通
        31
    lonelygo   228 天前
    @Mayuri +1,想不通好久了
    关于   ·   FAQ   ·   API   ·   我们的愿景   ·   广告投放   ·   感谢   ·   实用小工具   ·   2400 人在线   最高记录 5043   ·     Select Language
    创意工作者们的社区
    World is powered by solitude
    VERSION: 3.9.8.3 · 24ms · UTC 12:16 · PVG 20:16 · LAX 04:16 · JFK 07:16
    ♥ Do have faith in what you're doing.