Markdown Viewer 项目常见问题解决方案

项目基础介绍

Markdown Viewer 是一个开源的浏览器扩展项目，旨在提供一个方便的方式来预览和渲染 Markdown 文件。该项目支持多种浏览器，包括 Chrome、Firefox、Edge、Opera、Brave 和 Vivaldi。Markdown Viewer 的主要功能包括本地和远程文件 URL 的渲染、多种 Markdown 解析器、自定义主题支持、GitHub Flavored Markdown (GFM) 支持、自动重新加载、语法高亮代码块、目录生成、MathJax 公式和 Mermaid 图表等。

该项目主要使用 JavaScript 编写，适合前端开发者和 Markdown 文件的使用者。

新手使用注意事项及解决方案

1. 安装扩展后无法渲染本地 Markdown 文件

问题描述：在安装 Markdown Viewer 扩展后，尝试打开本地 Markdown 文件时，浏览器无法正确渲染文件内容。

解决步骤：

1. 打开扩展管理页面：

   • 在 Chrome 浏览器中，导航到 chrome://extensions。
   • 在 Firefox 浏览器中，导航到 about:addons。

2. 启用文件 URL 访问权限：

   • 找到 Markdown Viewer 扩展，点击“详细信息”或“更多信息”。
   • 确保“允许访问文件 URL”开关已打开。

3. 重新加载文件：

   • 关闭并重新打开 Markdown 文件，确保浏览器能够正确渲染。

2. 远程文件渲染失败或被阻止

问题描述：尝试渲染远程 Markdown 文件时，浏览器显示错误或文件内容无法正确渲染。

解决步骤：

1. 打开扩展的高级选项：

   • 点击浏览器工具栏中的 Markdown Viewer 图标。
   • 选择“高级选项”。

2. 添加允许的远程源：

   • 在“管理源”部分，添加你希望允许渲染的远程文件的 URL 或域名。
   • 确保 URL 格式正确，例如 https://example.com。

3. 保存并测试：

   • 保存设置后，尝试重新加载远程 Markdown 文件，确保内容能够正确渲染。

3. 自定义主题上传失败或无法应用

问题描述：尝试上传自定义主题时，上传失败或上传后主题无法正确应用。

解决步骤：

1. 检查主题文件格式：

   • 确保自定义主题文件是一个有效的 CSS 文件。
   • 文件大小不超过 8KB。

2. 上传自定义主题：

   • 在 Markdown Viewer 的高级选项中，选择“设置”。
   • 选择“CUSTOM”作为内容主题。
   • 点击“上传自定义主题”按钮，选择你的 CSS 文件并上传。

3. 应用主题：

   • 上传成功后，确保主题已正确应用到 Markdown 文件的渲染中。
   • 如果主题未生效，尝试刷新页面或重新加载 Markdown 文件。

通过以上步骤，新手用户可以解决在使用 Markdown Viewer 项目时常见的问题，确保项目能够正常运行并满足需求。