Sublime Text 3 使用 Markdwon 遇到问题及解决

前言

本文记录了 sublime text 的常用的必需的功能,包括安装、设置和卸载插件,查看安装了哪些插件,查看运行 log ( sublime text 出现问题时这个很有用),另外记录了使用时遇到的问题及解决方法。

常用功能

安装插件

自己用的插件

目前只用到这几个:

  • Compare Side-By-Side : 这个是文档比较用的,比较实用。

  • Markdown Editing :markdown 编辑器,markdown 语法它会认的。

  • OmniMarkupPreviewer :这个是用于浏览器实时预览 markdown 文本的插件,很好用,就一个够用了。

  • MarkdownLivePreview :这个是在 sublime text 下实时预览 markdown 文本的插件,也很好用(网上说会有点卡。是会有点卡,但是看着方便,不用老是切换去看浏览器)。

操作方式有 2 种:

  1. 通过菜单 Tools->Command Palette

  2. 通过菜单 Preferences->Package Control

下面讲下方式 1 的具体步骤。

具体安装步骤

  • 点击 Tools->Command Palette(这里可以看到快捷键 Ctrl+Shift+P),看图1

  • 之后出现图2,输入要操作的安装命令:Install Package (会有自动提示)

  • 接着出现图3(图 3 出现可能会等个几秒几十秒不等),输入要安装的插件名称:Markdown Editing(这里随便举一个)

  • 最后在图3直接点击出现的要安装的插件即可(这里也可以输入插件全名,然后回车)

  • 安装完了需要重启 sublime text,新安装的插件才能正常使用

图 1 Command Palette

DF

图 2 选择 Install Package

图 3 选择要安装的插件

上面就是方式 1 ,现在可以操作一番了。

方式 2 的步骤和方式 1 一样,这里不详细说了(文章太长估计都不想看了)。

安装完了,可能要看下有没有安装成功,那么请看查看装了哪些插件一小节

设置插件

菜单 Preferences->Package Settings,这里会列出所有安装成功且可以设置的插件(不能设置的插件不会在这里显示),看图4。

图 4 插件设置及可设置的插件列表

点击图 4 的第三列菜单项中的某一项就可以设置了,这里的具体功能可以慢慢摸索。

卸载插件

对应于安装插件,肯定也有卸载插件功能。和安装插件方式相同,也有 2 种:

  1. 通过菜单 Tools->Command Palette(快捷键:Ctrl+Shift+P)

  2. 通过菜单 Preferences->Package Control

不过接下来要在图 2 输入的命令是 Remove Package,稍等会弹出图 3 后,会列出已经安装成功的插件,然后用鼠标选择点击即可。

查看装了哪些插件

看到这里可能已经知道了 2 种查看已安装插件的方式:

  1. 通过设置插件来查看,见图 4 的红框。当然这只能查看可以修改配置的插件(好多个)

  2. 通过卸载插件来查看,见图 2。
    因为卸载插件会让你选择已安装的插件,当然就可以看了。

另外还有一种方式,也是最正宗的,到 sublime text 数据目录里查看,见图 5,6:

图 5 浏览插件

图 6 插件目录

图 6 红框中的路径要重点关注。这个目录往上一层可以看到有个文件夹 Installed Packages,这里就包含了所有已安装的插件。

查看运行 log

看 sublime text 运行 log,主要是因为修改插件配置不生效,或者修改了配置产生了问题,那么此时就要看 log 查下问题根源(我很喜欢看 log),见图 7, 8。

图 7 显示 log

图 8 底部出现 console log

console log 的界面是出现在底部的,在图 7 上可以看到它的快捷键:Ctrl+`(键盘左上角那个点,与 1 键盘位相邻), 按一下出现,再按下消失。

遇到问题及解决

在使用过程中还是遇到了些问题。问题总是有的,解决方法总是要自己找的。下面列了 4 个问题和解决方法。

OmniMarkupPreviewer 预览出现 404 错误

  • 导致这个错误的原因:

    已经装了 OmniMarkupPreviewer 插件,但是又装了 Markdown Preview 插件,导致冲突。

  • 解决方法:

    Markdown Preview 插件 卸载就预览正常了。

    查看 console log,是包未安装,加载错误,但是插件是安装成功的,再加上之前 OmniMarkupPreviewer 插件运行正常,同时又想起新装了另外个预览插件,所以很有可能就是两个插件冲突了(回忆之前做了什么对解决问题很重要)。

  • 网上的方法(当然也是有效的,但不适合我这里):

    修改 OmniMarkupPreviewer 插件配置,把

    "extensions": ["strikeout", "tables", "fenced_code", "codehilite"] 
    

    改为

    "extensions": [] 
    

设置自定义预览浏览器出错

  • 导致这个错误的原因:

    按指定的格式设置,但是与 python3.3 不兼容,看 console log,出错位置 OmniMarkupPreviewer.py 的第 80 行在见图 9。

    图 9 自定义浏览器设置错误

  • 解决方法(网上找的):

    • 一设置格式为:

      "browser_command": ["C:\\Program Files (x86)\\Mozilla Firefox\\firefox.exe", "{url}"],
      
    • 二注释掉不兼容的处理 browser_command 这个参数的语句,在OmniMarkupPreviewer.py 的第 80 行 附近,见图 10。

      图 10 注释掉不兼容语句
      经过上面的处理,右击->Preview Markup in Browser,预览正常。
      重点说明:如果想 MarkdownLivePreview 插件和 OmniMarkupPreviewer 插件一起用,得先启用 MarkdownLivePreview 插件,之后再启用 OmniMarkupPreviewer 插件。如果顺序反了,OmniMarkupPreviewer 插件的实时预览就失效了。

    • 参考:
      [1] https://github.com/timonwong/OmniMarkupPreviewer/issues/80

Markdown Edit 插件色系选择 和 开启 Latex 公式功能

这两个设置功能较简单,但也很常用,简单说下。

  • 选择 Markdown Editing 插件色系

    菜单 Preferences->Package Setttings->Markdown Editing->Change color scheme

  • 开启 Latex 公式功能

    菜单 Preferences->Package Setttings->OmniMarkupPreviewer->Setting - Default,
    修改相应配置为:

    "mathjax_enabled": true,
    

    就可以了。

最后

把这些记录下,将来忘记了可以来这里找找感觉。

这篇断断续续搞了几个小时,主要是对 markdown 语法不熟,还得多多写写啊。。。

posted @ 2023-04-30 19:55  ALLEN_2008  阅读(197)  评论(0编辑  收藏  举报