安装AsciiDoc插件并关联文件类型即可实现高亮。1. 通过Package Control安装插件；2. 使用命令面板搜索并安装AsciiDoc或AsciiDocPlus；3. 将.adoc文件关联为AsciiDoc语法；4. 打开测试文件验证标题、代码块等是否正确高亮。

要让 Sublime Text 正确高亮 .adoc 或 .asciidoc 文件，你需要安装 AsciiDoc 语法支持插件。Sublime Text 默认不包含 AsciiDoc 语法高亮，但通过 Package Control 安装相关插件后即可实现。

1. 安装 Package Control（如果尚未安装）

Package Control 是 Sublime Text 的插件管理工具，绝大多数语法包都通过它来安装。

打开 Sublime Text，按下 Ctrl+`（或菜单 View → Show Console），粘贴以下代码并回车：

 import urllib.request,os,hashlib; h = '6f4c264a663c929981e81053e0a27682' + '9d22b38'; pf = 'Package Control.sublime-package'; ipp = sublime.installed_packages_path(); urllib.request.install_opener( urllib.request.build_opener( urllib.request.ProxyHandler()) ); by = urllib.request.urlopen( 'http://packagecontrol.io/' + pf.replace(' ', '%20') ).read(); dh = hashlib.sha256(by).hexdigest(); print('Error validating download: %s' % dh) if dh != h else open(os.path.join( ipp, pf), 'wb' ).write(by) 

安装完成后重启 Sublime Text。

2. 安装 AsciiDoc 插件

使用 Package Control 安装 AsciiDoc 语法包：

• 按下 Ctrl+Shift+P 打开命令面板
• 输入 Install Package，选择 “Package Control: Install Package”
• 等待列表加载，搜索并选择 AsciiDoc
• 点击安装

常用插件名称是：AsciiDoc（由 maze-for-ascii 维护）或 AsciiDocPlus（功能更全，推荐）。

3. 设置文件关联（自动高亮）

确保 .adoc 或 .asciidoc 文件自动使用 AsciiDoc 语法高亮：

• 打开一个 .adoc 文件
• 点击右下角显示的语法（如“Plain Text”）
• 选择 AsciiDoc → AsciiDoc

之后所有 .adoc 文件会默认用该语法高亮。你也可以手动修改文件关联：

标贝悦读AI配音

在线文字转语音软件-专业的配音网站

20

查看详情

• 打开一个 adoc 文件后，进入菜单 View → Syntax → Open all with current extension as… → AsciiDoc → AsciiDoc

4. 验证高亮效果

打开一个内容如下的测试文件：

 = 文档标题 :author: 张三 <p>== 第一节</p><p>这是一个段落。</p><ul><li>加粗文本 ** 更粗的文本</li></ul><h2>[source,java]</h2><p>public class Hello { public static void main(String[] args) { System.out.println("Hello"); } } ----

如果标题、列表、代码块等都有不同颜色，说明高亮已生效。

基本上就这些。安装插件 + 关联语法，就能获得良好的 AsciiDoc 编辑体验。