V2EX = way to explore
V2EX 是一个关于分享和探索的地方
现在注册
已注册用户请  登录
mirone
V2EX  ›  程序员

Milkdown 中文文档

  •  5
     
  •   mirone · 2021-08-13 09:22:41 +08:00 · 8567 次点击
    这是一个创建于 1196 天前的主题,其中的信息可能已经有所发展或是发生改变。

    最近终于把文档的本地化做好了,立刻加上了中文文档,欢迎大家阅读和使用。

    链接: https://saul-mirone.github.io/milkdown/#/zh-hans

    第 1 条附言  ·  2021-08-15 12:32:53 +08:00

    有些朋友问能不能自定义样式,答案当然是可以

    theme

    87 条回复    2021-12-22 12:49:46 +08:00
    moxuanyuan
        1
    moxuanyuan  
       2021-08-13 09:26:29 +08:00
    不错
    agagega
        2
    agagega  
       2021-08-13 09:32:17 +08:00 via iPhone
    感觉有些像 Editor.js ?
    ss098
        3
    ss098  
       2021-08-13 09:52:40 +08:00
    体验了一下,很强。
    Shook
        4
    Shook  
       2021-08-13 09:56:27 +08:00
    体验了下,发现修复了之前弹框位置超出的 bug,还行。
    aircjm
        5
    aircjm  
       2021-08-13 09:58:29 +08:00 via Android
    quasar 用的不是 vite 好像用不了 虽然也是 vue3 了
    mirone
        6
    mirone  
    OP
       2021-08-13 10:00:12 +08:00
    @agagega 编辑器总是大同小异的,我这边主打的是基于 markdown 和扩展性两点
    ipwx
        7
    ipwx  
       2021-08-13 10:00:20 +08:00
    很强!!!!盼望这玩意儿好久了!!!!

    可以愉快的 hack 自己的笔记软件了。
    mirone
        8
    mirone  
    OP
       2021-08-13 10:00:43 +08:00
    @Shook 之前的 bug 基本都修复啦
    mirone
        9
    mirone  
    OP
       2021-08-13 10:01:47 +08:00
    @aircjm 其实我不是 vue 专家,但是之前帮几个用户看过基于 vue-cli 创建的仓库,是能够跑起来的
    ipwx
        10
    ipwx  
       2021-08-13 10:01:51 +08:00
    @mirone 就数学公式行内显示这一点,真的是长久以来根本没有可选项。左右双栏在大段公式的情况下真的是没法用,特别是如果我还要边推公式边写。除了 Typora 没有可以用的,但是 Typora 没法 hack 。

    有一个小建议:Typora 正在编辑的公式会在下方显示一个小框实时预览。大佬您看……?(厚颜无耻)
    mirone
        11
    mirone  
    OP
       2021-08-13 10:03:33 +08:00
    @ipwx 这个可以安排一下,劳烦您提一个 issue,实时预览框应该是可以实现的
    ipwx
        12
    ipwx  
       2021-08-13 10:04:01 +08:00
    @mirone QAQ 好的这就去提(顿首)
    aircjm
        13
    aircjm  
       2021-08-13 10:06:39 +08:00
    @mirone 哈哈哈 我是做后端的 前端太复杂了
    wangjiang
        14
    wangjiang  
       2021-08-13 10:17:54 +08:00
    Hanser002
        15
    Hanser002  
       2021-08-13 10:26:38 +08:00   ❤️ 1
    不错 牛啊兄弟
    andyskaura
        16
    andyskaura  
       2021-08-13 10:31:28 +08:00   ❤️ 1
    支持支持!
    mirone
        17
    mirone  
    OP
       2021-08-13 10:31:44 +08:00
    @wangjiang 您好,这可能是由于众所周知的网络原因导致谷歌的 material icon 图标库没有加载出来....
    v2ka
        18
    v2ka  
       2021-08-13 10:32:35 +08:00
    這個產品做的真讓人舒服。

    只是面向的應該是開發人員。

    讓很多普通用戶無法下手。

    總之不錯~加油呀~
    balabalaguguji
        19
    balabalaguguji  
       2021-08-13 10:37:16 +08:00   ❤️ 1
    这个很棒
    SenLief
        20
    SenLief  
       2021-08-13 10:42:50 +08:00
    希望有人出个产品来看看,毕竟不熟悉前端呀。
    JackalZhao
        21
    JackalZhao  
       2021-08-13 10:42:55 +08:00
    使用 Typora 最大的问题就是长文的性能问题,milkdown 的性能如何,所见即所得编辑器的性能有什么好的评价指标吗?
    fidetro
        22
    fidetro  
       2021-08-13 11:17:52 +08:00
    链接里 GitHub 仓库不好找,想给个 star 找了好久,结果原来在右上角的分享按钮,感觉那个按钮可以改成 GitHub 的那只猫图标
    mirone
        23
    mirone  
    OP
       2021-08-13 11:21:02 +08:00
    @v2ka 希望普通用户也可以通过插件来更方便的使用吧,类似 gitbook,还需要更多的插件来做到这件事
    mirone
        24
    mirone  
    OP
       2021-08-13 11:21:40 +08:00
    @SenLief 后续可能会用这个单独做一款笔记软件
    mirone
        25
    mirone  
    OP
       2021-08-13 11:23:37 +08:00
    @JackalZhao 这就取决于 prosemirror 的性能了,我其实没有单独搞过 benchmark
    mirone
        26
    mirone  
    OP
       2021-08-13 11:23:51 +08:00
    @fidetro 好的,感谢建议
    darrh00
        27
    darrh00  
       2021-08-13 11:29:03 +08:00
    体验真不错, 有没有可能用这个库做个 vscode 的插件?
    mirone
        28
    mirone  
    OP
       2021-08-13 11:56:47 +08:00
    @darrh00 没有研究过 vscode 插件,如果支持 web view 或者 iframe 的话应该是没问题的
    484A4B
        29
    484A4B  
       2021-08-13 12:02:22 +08:00
    真不错啊 支持一下
    root01
        30
    root01  
       2021-08-13 12:02:40 +08:00
    Typora 牛逼
    code4you
        31
    code4you  
       2021-08-13 12:30:11 +08:00
    颜值不错 😁
    shawndev
        32
    shawndev  
       2021-08-13 12:32:29 +08:00
    不错
    SenLief
        33
    SenLief  
       2021-08-13 12:33:56 +08:00
    @mirone 先整个 web 版本的出来,这个容易。
    SuperManNoPain
        34
    SuperManNoPain  
       2021-08-13 13:04:26 +08:00
    好东西
    Lemeng
        35
    Lemeng  
       2021-08-13 13:14:43 +08:00
    不错不错,绑定一下
    rita413413
        36
    rita413413  
       2021-08-13 13:18:48 +08:00
    请问楼主 文档你使用的是什么框架生成的呢?
    Aixtuz
        37
    Aixtuz  
       2021-08-13 13:31:40 +08:00
    代码块点击语言名称会弹出列表,点击向下箭头反而不会?
    jingslunt
        38
    jingslunt  
       2021-08-13 13:52:45 +08:00
    有 wasm 格式的吗?想把文档全部渲染一下
    musi
        39
    musi  
       2021-08-13 14:01:19 +08:00
    先 star 一波,不过你这网站上的 github 链接是真不显眼,搞了个毫无关系的图表我还找了半天
    LittleDust
        40
    LittleDust  
       2021-08-13 14:24:46 +08:00
    nice
    cweijan
        41
    cweijan  
       2021-08-13 14:24:53 +08:00   ❤️ 1
    不错, 很漂亮
    saltbo
        42
    saltbo  
       2021-08-13 14:34:52 +08:00   ❤️ 1
    棒啊,前几天我刚给 zpan 里集成了一个 markdown 编辑器,但是不是太满意。 看到楼主目标是想做成 notion 那样的,期待一下。 我看下能不能把之前集成的换成你这个,我本来的目标是可以让我的用户可以方便的编辑 zpan 里的 md 文件。现在有了你这个项目,我觉得完全可以目标改为:自建版本的 Notion
    hxse
        43
    hxse  
       2021-08-13 14:34:55 +08:00
    @mirone 支持双向链接吗, 或者写个插件来支持, 可行吗?
    Joeith
        44
    Joeith  
       2021-08-13 15:07:48 +08:00
    不知道 Obsidian 的编辑器能换成这个吗,估计要大改了
    jupiter157
        45
    jupiter157  
       2021-08-13 15:10:01 +08:00
    点开了一下在线体验,你这 bug 有点多啊
    1. 开篇的链接用的是中文括号,所以没有链接,还让我研究了好一会链接在哪里
    2. 代码块下拉箭头无效
    3. 你的行内代码格式显示‘|’符号非常不友好,直接上下顶头了,让人看不出来这是啥
    kokdemo
        46
    kokdemo  
       2021-08-13 15:26:35 +08:00
    好强,给楼主点赞
    mirone
        47
    mirone  
    OP
       2021-08-13 15:37:48 +08:00
    @rita413413 是自己用 react 做的,源码在仓库的 gh-pages 目录里
    mirone
        48
    mirone  
    OP
       2021-08-13 15:38:10 +08:00
    @Aixtuz 这个是已知的一个问题,在修复了
    mirone
        49
    mirone  
    OP
       2021-08-13 15:38:28 +08:00
    @musi 好像确实不太明显
    xingheng
        50
    xingheng  
       2021-08-13 15:39:48 +08:00
    我要 PlantUML !
    mirone
        51
    mirone  
    OP
       2021-08-13 15:40:21 +08:00
    @jupiter157 感谢您的建议,1 、3 算是体验上面的问题,2 是一个已知问题,正在修复,如果您找到更多问题也欢迎反馈
    mirone
        52
    mirone  
    OP
       2021-08-13 15:40:47 +08:00
    @hxse 请问什么是双向链接
    mirone
        53
    mirone  
    OP
       2021-08-13 15:41:37 +08:00
    @wangyanchen126 这种闭源软件的就看他们自己的想法了,外人很难插手
    mirone
        54
    mirone  
    OP
       2021-08-13 15:42:37 +08:00
    @xingheng 后续计划通过这个支持流程图: https://mermaid-js.github.io/mermaid/#/
    jiayong2793
        55
    jiayong2793  
       2021-08-13 15:50:21 +08:00
    markdown 最大的缺点是不通解析器有不同的解析规则,你的工具写出的文档能在其他地方正常显示吗?
    mirone
        56
    mirone  
    OP
       2021-08-13 16:02:28 +08:00
    @jiayong2793 markdown 的特点是灵活,所以很多不同工具都有不同的扩展,markdown 是有两套比较常用的语法规范,一个是最基本的 markdown 语法 commonmark,还有一个是 github 在用的 gfm,milkdown 支持了这两种规范。对于有自己特殊定制语法的软件,就无法支持了。
    hxse
        57
    hxse  
       2021-08-13 16:14:38 +08:00
    @mirone #52 参考一下: https://sspai.com/post/67996
    大概就是可以对文章元素进行较细粒度的引用
    creanme
        58
    creanme  
       2021-08-13 16:24:56 +08:00   ❤️ 1
    体验了一下,挺牛逼的
    olbb
        59
    olbb  
       2021-08-13 16:35:01 +08:00   ❤️ 1
    挺好的 加油
    mirone
        60
    mirone  
    OP
       2021-08-13 16:51:06 +08:00
    @hxse 感谢科普,这个是可以通过插件实现的
    ClarkAbe
        61
    ClarkAbe  
       2021-08-13 16:51:17 +08:00   ❤️ 1
    star
    killua67
        62
    killua67  
       2021-08-13 17:16:06 +08:00
    挺厉害的。
    creaink
        63
    creaink  
       2021-08-13 17:19:07 +08:00
    有支持 VSCode 插件的计划么?
    xiadd
        64
    xiadd  
       2021-08-13 17:21:21 +08:00
    nice
    nekoneko
        65
    nekoneko  
       2021-08-13 17:27:43 +08:00
    强👍👍
    mirone
        66
    mirone  
    OP
       2021-08-13 17:48:16 +08:00
    @creaink 如果之后有空可以做一下,暂时没有更多精力了
    JawnHa
        67
    JawnHa  
       2021-08-13 17:50:15 +08:00
    emmm 能拿来做 markdown 的渲染吗?还是只是个编辑器
    mirone
        68
    mirone  
    OP
       2021-08-13 17:51:05 +08:00
    @JawnHa 你猜猜文档是用什么渲染的?
    stimw
        69
    stimw  
       2021-08-13 18:56:14 +08:00
    支持一下
    kokdemo
        70
    kokdemo  
       2021-08-13 19:03:50 +08:00
    obisdian 的编辑器要是能有这个感觉就爽了
    lizhesystem
        71
    lizhesystem  
       2021-08-13 19:09:32 +08:00
    做编辑器的一般都是大神😁
    JackalZhao
        72
    JackalZhao  
       2021-08-13 20:45:36 +08:00
    输入体验还是很棒的,期待以后的编辑器、笔记软件。希望语法上可以支持一些 markdown 拓展语法,例如 markdown admonition 语法。
    mirone
        73
    mirone  
    OP
       2021-08-13 21:13:16 +08:00
    @JackalZhao milkdown 最大的特点就是扩展性比较好,文档中甚至有一篇专门教用户如何编写自定义扩展语法的
    https://saul-mirone.github.io/milkdown/#/zh-hans/example-custom-syntax
    lightjiao
        74
    lightjiao  
       2021-08-14 00:48:06 +08:00
    强,一直想要一个支持多种扩展语法的 markdown 编辑器
    虽然 Typora 已经支持了很多,但 latex 支持得不全,而且 github pages 博客也几乎没有支持 markdown 扩展语法的
    LeeReamond
        75
    LeeReamond  
       2021-08-14 05:25:06 +08:00
    https://imgur.com/mLg8AY1

    帮忙捉个虫,编辑模式下右页高度,有问题,横移还有行重合问题,另外公式标记符没有高亮。
    不过说实话我没有太搞清楚这个项目的点
    LeeReamond
        76
    LeeReamond  
       2021-08-14 05:25:32 +08:00


    v2ex 怎么发图来着。。
    quericy
        77
    quericy  
       2021-08-14 08:15:32 +08:00
    体验了下还不错~

    不过双栏编辑模式下,右侧的宽度感觉有点窄,显示不了几个字符就得滑动着看
    marcosteam
        78
    marcosteam  
       2021-08-14 09:36:05 +08:00
    @wangyanchen126 你跟我想到一块了
    mirone
        79
    mirone  
    OP
       2021-08-14 09:55:36 +08:00
    @LeeReamond 因为右页其实并不是 milkdown 的一部分,它只是为了让你看到你输入的 markdown 原文是什么,milkdown 本身是指左半部分,那里是可以直接编辑的。
    mirone
        80
    mirone  
    OP
       2021-08-14 09:56:36 +08:00
    @quericy 因为右页其实并不是 milkdown 的一部分,它只是为了让你看到你输入的 markdown 原文是什么,milkdown 本身是指左半部分,那里是可以直接编辑的,所以我没有花精力去对右半部分做很多调整。
    005008
        81
    005008  
       2021-08-15 16:37:44 +08:00
    很棒,先收藏一下~最近在用 slatejs 做~
    mirone
        82
    mirone  
    OP
       2021-08-20 17:48:39 +08:00   ❤️ 1
    darrh00
        83
    darrh00  
       2021-08-20 19:07:03 +08:00
    @mirone

    已经用上,太赞了~~~
    librer
        84
    librer  
       2021-09-16 10:15:28 +08:00
    作为普通用户表示一脸懵逼,不知道该怎么用。所以说,这软件有没有客户端的?是只有 web 端吗?
    balabalaguguji
        85
    balabalaguguji  
       2021-12-22 11:36:05 +08:00
    请问这个可以添加自定义的语法吗?比如我要加`>r 这是一个红色背景的引用块`,似乎识别不了,报错:Uncaught Error: Cannot handle unknown node `redquote`
    mirone
        86
    mirone  
    OP
       2021-12-22 12:17:49 +08:00
    @balabalaguguji issue 里回复你了
    balabalaguguji
        87
    balabalaguguji  
       2021-12-22 12:49:46 +08:00
    @mirone 看到了,感谢
    关于   ·   帮助文档   ·   博客   ·   API   ·   FAQ   ·   实用小工具   ·   1158 人在线   最高记录 6679   ·     Select Language
    创意工作者们的社区
    World is powered by solitude
    VERSION: 3.9.8.5 · 34ms · UTC 18:08 · PVG 02:08 · LAX 10:08 · JFK 13:08
    Developed with CodeLauncher
    ♥ Do have faith in what you're doing.