Milkdown 中文文档 - V2EX
V2EX = way to explore
V2EX 是一个关于分享和探索的地方
现在注册
已注册用户请  登录
请不要在回答技术题时复制粘贴 AI 生成的内容
mirone
V2EX    程序员

Milkdown 中文文档

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

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

    链接: 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 的性能如何,所见即所得编辑器的性能有什么好的评价指标吗?
    rico2logout
        22
    rico2logout  
       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     Solana     922 人在线   最高记录 6679       Select Language
    创意工作者们的社区
    World is powered by solitude
    VERSION: 3.9.8.5 31ms UTC 18:49 PVG 02:49 LAX 11:49 JFK 14:49
    Do have faith in what you're doing.
    ubao 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