wizard icon indicating copy to clipboard operation
wizard copied to clipboard

markdown问题

Open chenlw527 opened this issue 4 years ago • 2 comments

看了该项目起源,该项目确实比较好,给作者点个大大的赞!!! 还是说一下我体验的问题。 最近在体验选择文档管理的开源软件,当期我们项目基本也是使用showdoc。唯一的缺陷就是团队大了,对于的文档质量反馈无法得到很好的体现。这个项目让我看到了希望,主要的缺陷还是在markdown上面还存在一些问题,主要是相对于我使用showdoc软件的markdown,导致我不敢迁移。因为初始试用了2天,也不知道提的问题是否真的存在(版本1.26,应该是最新的) 1、markdown编辑换行问题,必须要有两空格+回车才能在展示真换行(这个问到是导致我不敢迁移的最大原因,迁移了换行的全部变成未换行了,工作量大) 2、引用应该功能有问题,和我看其它makrdown的引用不一样,这个引用是一个大的的引号,不能嵌套。 3、标题没有一级标题,但是使用markdown一级标题也会显示 4、关于文档标题生成导航,好像没有这个功能,但是用markdown的格式也能出来 5、导出PDF,似乎超过50行后面有丢掉了,不知是字数限制还是行数限制。(Editor.md 项目在线markdown编辑器说明拷贝如编辑器,导出PDF,导出半页,导出PDF提示部分文档导出失败) 我到扩展项目Editor.md 体验了在线的markdown编辑器,都不存在上述所见到的问题,功能存在一些差异,不知是不是未同步。 恕我孤陋寡闻,我只是和我想迁移的showdoc对比,跟多站在了个人使用维度,说错了忘作者海涵。 期待:因为文档主要用markdown编辑比较多而且常用,如果能完善且稳定,体验一定有很大的提升。

chenlw527 avatar Jan 22 '21 06:01 chenlw527

感谢反馈,刚刚发布了 1.2.7 版本,1-4 这几个问题应该都可以解决了:

  • 增加配置项 WIZARD_MARKDOWN_STRICT 来控制是否启用 Markdown 文档的兼容模式,用于解决呢问题 1
  • 增加配置项 WIZARD_MARKDOWN_TOC_DEFAULT 来控制是否为 Markdown 文档自动添加目录,解决问题 4
  • Markdown 文档中,引用块样式调整,恢复默认样式,用于解决问题 2,添加了一级标题菜单,解决问题 3

最后, PDF 导出问题后续有进展再来同步。

mylxsw avatar Jan 24 '21 13:01 mylxsw

感谢反馈,刚刚发布了1.2.7版本,1-4这几个问题应该都可以解决了:

  • 增加配置项WIZARD_MARKDOWN_STRICT来控制是否启用Markdown文档的兼容模式,用于解决呢问题1
  • 增加配置项WIZARD_MARKDOWN_TOC_DEFAULT来控制是否为Markdown文档自动添加目录,解决问题4
  • Markdown文档中,引用块样式调整,恢复替换样式,用于解决问题2,添加了一级标题菜单,解决问题3

最后,PDF导出问题后续有进展再来同步。

经测试: 第1个问题经更新测试,问题未解决。 第2个问题已解决 第3个问题已解决 第4个问题:当前是新增任何文档均有下拉目录,没有标题也会显示。建议通过[tocm] [toc]控制

chenlw527 avatar Jan 25 '21 02:01 chenlw527