Markdown预览与构建插件：MarkdownPreview使用教程

---

一、项目目录结构及介绍

MarkdownPreview是一个专为Sublime Text设计的插件，它使用户能够快速在网页浏览器中预览和构建Markdown文件。以下是该仓库的基本目录结构及其简要说明：

MarkdownPreview/
├── LICENSE.md          # 许可证文件，详细说明了使用条款。
├── README.md           # 项目的主要读我文件，包含概述和安装指南等。
├── sublime-commands    # Sublime Text命令定义文件夹。
├── sublime-build       # Markdown构建系统的设置文件。
├── sublime-menu        # 主菜单项，用于Sublime Text集成。
├── sublime-settings    # 用户和默认设置文件，允许自定义插件行为。
├── docs                # 文档相关文件，可能包含额外的帮助文档。
├── examples            # 示例Markdown文件，供用户参考。
├── tests               # 测试脚本和数据，确保插件功能正常。
└── ...                 # 包括源代码（py）、依赖管理文件(json), 配置文件(yml)等。

项目的核心逻辑主要分布在.py文件中，如markdown_preview.py, markdown_settings.py, 和其他处理预览和构建流程的脚本。CSS和JavaScript资源允许用户自定义外观和扩展功能。

二、项目的启动文件介绍

虽然这个插件没有一个传统意义上的“启动文件”，它的激活和使用主要是通过Sublime Text内的命令调用来完成。用户可以通过以下方式启动插件功能：

• 在Sublime Text中，通过快捷键或者从菜单访问“Tools” > “Markdown Preview”来触发预览或构建过程。
• 插件提供了多种预览选项，包括使用本地解析器或在线API（GitHub或GitLab），这些操作通常绑定到特定的命令上。

启动的核心在于配置好的命令（位于sublime-commands）和用户设置（sublime-settings），用户无需直接编辑Python源码来操作。

三、项目的配置文件介绍

默认与用户设置 (sublime-settings)

• 默认设置 (MarkdownPreview.sublime-settings) 提供了许多预先设定的选项，如选择默认的Markdown解析器、是否开启自动重载等功能。
• 用户设置 用户可以在自己的Sublime Text设置中创建或修改User级别的MarkdownPreview.sublime-settings文件，以覆盖默认值。这允许个性化的配置，比如自定义预览使用的CSS样式表、JavaScript文件，或是切换API服务提供商。

额外配置

• LiveReload集成 若已安装LiveReload插件，可通过配置启用保存时自动刷新浏览器的功能。
• 外部Markdown解析器 用户可通过配置指定使用外部解析器路径，增加灵活性。
• CSS与JS资产 可以配置自定义的CSS和JavaScript文件链接，以便为预览添加额外样式或交互逻辑。

总结来说，MarkdownPreview通过其详尽的设置系统为用户提供高度定制化的工作流，无论是希望通过本地渲染进行离线预览，还是想利用云端服务以获取更丰富的Markdown支持，都能找到相应的配置方法。通过Sublime Text的界面即可轻松管理和调整这些配置，无需深入代码层面。