在 Devin 中试用 DeepWiki 处理私有仓库
DeepWiki

adam-p/markdown-here

菜单

用户界面

相关源文件

Markdown Here 的用户界面是用户与扩展功能交互的组件集合。本文档涵盖了浏览器集成点、选项页面结构和配置存储机制，这些机制使用户能够自定义其 Markdown 渲染体验。

有关实际 Markdown 渲染过程的信息，请参阅Markdown 渲染管道。

UI 组件概述

Markdown Here 提供了多个接口点，允许用户在不同浏览器和电子邮件客户端中访问其功能。

来源

主要 UI 集成点

浏览器工具栏按钮

该扩展在浏览器工具栏中添加了一个带有 Markdown Here 图标的按钮。在兼容的编辑环境中点击此按钮会触发 Markdown 切换功能。

上下文菜单集成

在 Gmail、Thunderbird 和其他基于网络的编辑器等受支持的环境中编辑时，Markdown Here 会在右键单击上下文菜单中添加一个“Markdown 切换”条目。

键盘快捷键

键盘快捷键（默认：CTRL+ALT+M）提供对切换功能的快速访问。此快捷键可以在选项页面中自定义。

来源

选项页面结构

选项页面是 Markdown Here 的中央配置中心，提供用于自定义扩展行为和外观的控件。

来源

基本用法和资源

选项页面的顶部部分提供了

  • Markdown Here 的分步使用说明
  • 文档、备忘单和支持资源的链接
  • 捐赠选项

来源

样式控制

本节允许用户通过以下方式自定义渲染 Markdown 的外观：

主 CSS 编辑器

  • 用于自定义渲染 Markdown 基本样式的文本编辑器
  • “重置为默认”按钮以恢复原始样式
  • 更改会自动保存和预览

语法高亮主题

  • 用于选择预定义语法高亮主题的下拉选择器
  • 用于自定义或查看当前主题代码的 CSS 编辑器
  • 适用于渲染 Markdown 中的代码块

来源

预览部分

预览部分提供了 Markdown 将如何使用当前设置进行渲染的实时演示

  • 显示当前 CSS 设置下渲染的 Markdown 的 iframe
  • Markdown 切换按钮，用于在渲染的 HTML 和原始 Markdown 之间切换
  • 关于样式行为的注意事项

来源

配置控件

TeX 数学支持

  • 数学公式渲染的启用/禁用复选框
  • 用于自定义渲染所用 HTML 模板的输入字段
  • 重置按钮以恢复默认模板
  • 有关隐私考虑和自定义选项的文档

热键配置

  • 修饰键（Shift、Ctrl、Alt）的复选框
  • 主键的文本输入
  • 非字母数字键的警告
  • 关于热键行为的平台特定说明

高级选项

  • 忘记渲染检查：在发送包含未渲染 Markdown 的电子邮件时发出警告
  • 标题锚点：自动为标题添加 ID 锚点
  • GFM 换行符：启用 GitHub 风格的 Markdown 换行符处理

来源

配置存储系统

Markdown Here 使用跨平台存储系统来一致地管理用户在不同浏览器和电子邮件客户端中的偏好设置。

来源

默认配置值

该扩展为所有设置提供了合理的默认值

设置默认值描述
main-css默认 CSS 文件渲染 Markdown 的基本样式
syntax-cssGitHub 主题代码语法高亮外观
math-enabledfalseTeX 数学公式渲染切换
math-valueCodeCogs 渲染器数学渲染的 HTML 模板
hotkeyCTRL+ALT+M键盘快捷键组合
forgot-to-render-checkfalse未渲染 Markdown 的警告
header-anchors-enabledfalse自动标题锚点 ID
gfm-line-breaks-enabledtrueGitHub 风格的换行符

来源

设置同步

当使用具有同步功能的浏览器（Chrome、Firefox）时，启用浏览器同步功能后，Markdown Here 设置会自动跨设备同步。

来源

用户交互工作流程

Markdown 切换过程

使用 Markdown Here 的主要工作流程

来源

选项配置过程

设置更改的处理方式

来源

平台特定的 UI 差异

Markdown Here 会调整其 UI，以适当集成到不同的浏览器和电子邮件客户端中

平台按钮位置选项访问需要重新加载
Chrome/Opera浏览器工具栏扩展程序菜单否
Firefox浏览器工具栏附加组件页面是
Thunderbird消息窗口附加组件管理器是
Safari浏览器工具栏扩展程序标签页否

来源

本文档涵盖了 Markdown Here 的用户界面组件、其结构以及用户如何与它们交互。有关核心渲染功能的详细信息，请参阅 Markdown 渲染管道文档。