Atom Markdown 预览项目的安装与使用教程

1. 项目目录结构及介绍

Atom 的 Markdown 预览项目（https://github.com/atom/markdown-preview）的目录结构如下：

• CHANGELOG.md: 记录项目的版本变更历史。
• CONTRIBUTING.md: 对开发者如何贡献代码和修复bug的指南。
• LICENSE: 开源许可文件，通常为 MIT 或其他许可证。
• README.md: 项目的基本介绍、使用方法以及特性说明。
• lib: 核心代码库，包含了预览功能的主要实现。
• spec: 测试文件夹，用于单元测试和集成测试。
• static: 包含预览样式和其他静态资源。
• styles: 自定义CSS样式，用于自定义Markdown预览的外观。
• package.json: Node.js 包管理器使用的文件，包含项目依赖和元数据。

2. 项目启动文件介绍

在这个项目中，启动文件是 lib/main.coffee。它是Atom插件的主要入口点，负责监听事件并处理Markdown预览的相关逻辑。例如，当用户在Atom编辑器中打开或更改一个Markdown文件时，main.coffee 文件中的代码将触发预览的更新。

3. 项目的配置文件介绍

Atom Markdown 预览项目主要通过 Atom 的配置系统进行设置，用户可以个性化预览体验。这些设置通常在 config.cson（CoffeeScript Object Notation）文件中定义，但用户界面也提供了图形化的配置选项。以下是几个关键的配置项：

• markdown-preview Enhanced:enabled: 启用或禁用Markdown预览增强功能。
• markdown-preview Enhanced:usePandocParser: 使用Pandoc解析器代替默认解析器。
• markdown-preview Enhanced:katexEnable: 是否启用KaTeX数学公式支持。
• markdown-preview Enhanced:plantUmlEnable: 是否启用PlantUML图表支持。

要查看和修改这些设置，您可以在Atom编辑器中按下 cmd+, (Mac) 或者 ctrl+, (Windows/Linux)，然后搜索 markdown-preview 关键字找到对应的配置项。

注意: 安装和使用这个项目前，确保您已经安装了Atom编辑器。可以通过Atom官网下载并按照安装指南操作。完成安装后，在Atom中按 alt-shift-m 可以快速激活Markdown预览功能。如果需要安装此插件，可以通过Atom的包管理器（apm）执行 apm install markdown-preview-enhanced 命令。