最新消息:20210917 已从crifan.com换到crifan.org

【记录】试用Gitbook Editor去编辑Markdown的文章

Git crifan 4652浏览 0评论

折腾:

【记录】Mac本地搭建Gitbook环境

后,去试试。

“使用Gitbook桌面编辑器能够很方便的进行文章书写,终端环境下的Gitbook只是为了生成HTML文档与PDF文档而使用的。”

那就去写点内容再说。

【文章标题不支持中文?】

结果发现:

刚才写的中文标题变英文拼音了,难道标题不支持中文? 

干脆删了,重新创建

果然是有问题:

先不管这个bug。继续写点内容再说。

所以后续只能是:

【整理】Gitbook和Gitbook Editor使用心得

中的,在其他编辑器如VSCode中创建章节,回来Editor中继续编辑。

【目录支持中文】

可以编辑目录,写中文:

【支持插入本地图片或网络上图片】

去插入图片:

很明显:

没法直接粘贴图片进来

只能:

  • 网络图片地址

  • 本地拖进来

  • 本地选择文件进来

然后找了张本地图片拖进去了:

对于图片:除了不支持粘贴,总体体验还算凑合吧。 

后来在:

【整理】Gitbook和Gitbook Editor使用心得

中发现,可以从其他地方 拷贝 图片后,然后直接快捷键粘贴到Editor中。

【对于代码段的支持度还不错】

再去试试对于代码code的支持:

当输入“`后回车,自动就进去code区域了:

然后输入代码,然后点击Auto可以设置代码语言:

对于其他语言,可以手动输入:

但是没法自己手动去写:

“`

xxx

“`

【整理】印象笔记对于code代码的支持还可以

【查看和编辑Markdown源码】

后来发现,其实是可以自己编辑markdown的源码的:

点击右下角的❓问号 -》 Edit Markdown

就可以看到并编辑源码了:

在编辑markdown源码视图下,是有Show Preview预览的功能的:

【保存时会去除尾部多余空格:影响我的日常使用】

继续去试用发现个,自以为很智能的,但却影响我使用的功能:

当最后有空白的,其自以为的空行,则在保存时会自动删除掉

比如我在最后一行回车:

然后打算接着去其他地方粘贴内容过来

但是在粘贴之前保存了一下,导致空行就被清除了。。

这点还是比较讨厌的。

【不能完美支持粘贴过来的无须列表,但是自己写的可以正常编辑】

对于从印象笔记中拷贝过来的无序列表,支持度不够好,第二级的层级关系就错乱了:

-》

并且,按Tab或Shift+Tab,对于有些行,都无法增加/减少列表的层级

不过如果是自己手动输入,则对应的格式是正常的。

【新增章节】

可以新增章节:

【设置标题】

设置其他格式,比如2级标题

对于标题可以添加anchor

注意:不支持下划线,空格等,会自动变成短横线-

【查看markdonw源文件】

点击右下角问号-》Files

即可看到源文件:

但是只有图片可以预览:

其他md文件不给预览:

点击左上角的FILES,可以看到当前的markdown文件:

顺带也去看看.gitignore

对于自动生成的md文件名,觉得不爽,可以自己重命名:

然后也可以找到源文件所在Finder的位置:

【遇到bug:md重命名后文件内容丢失】

对于上面重命名的md文件,点击右键Reveal in Finder是灰色,无法点击的:

正觉得纳闷呢。

正巧打开了的Finder中,看到原因了:

新md文件名,是找不到的

旧md文件名还在,内容也还在

但是对于Editor编辑器中:

FILES中:

旧文件内容是空的

新文件内容却有:

TOC中:

(估计调用的也是Editor中的旧文件名,所以)

内容是空的:

关闭GitBook Editor后重新打开试试:

问题依旧。

不过无意间发现问题所在了:

SUMMARY.md中,仍旧是旧md文件名:

所以导致无法正常加载显示。

所以自己去把:

SUMMARY.md中的

* [HTTP简介](chapter1.md)

改为:

* [HTTP简介](ch1_http_intro.md)

同时也删除掉无用的:

chapter1.md

重启Editor,结果修改的内容又被Editor还原了:

所以在Editor中编辑SUMMARY.md

看看TOC中是否正常:

终于正常了,有内容了:

-》心得:

即使GitBook Editor有bug,也不要在非Editor环境下修改SUMMARY.md,否则Editor启动后会还原掉你的修改,只有去Editor中修改SUMMARY.md,改动才可以生效。

然后再去:

【记录】给Gitbook添加更多配置和功能

转载请注明:在路上 » 【记录】试用Gitbook Editor去编辑Markdown的文章

发表我的评论
取消评论

表情

Hi,您需要填写昵称和邮箱!

  • 昵称 (必填)
  • 邮箱 (必填)
  • 网址
100 queries in 0.202 seconds, using 23.34MB memory