洛谷 Markdown Editor（VSCode 扩展）

左侧编辑，右侧实时预览，侧边栏洛谷语法工具箱 + 官方规范一键排版修复 —— 在 VSCode 里无缝获得洛谷 Markdown 编辑体验。

┌─────────────────────────────────────────────────┐
│  活动栏   │  VSCode 编辑器  │   预览面板         │
│  (洛谷     │  (Markdown     │   (渲染后的        │
│   图标)    │   源码编辑)    │    HTML 预览)      │
│ 📝 文本格式│  # 标题        │   标题             │
│ 💻 代码    │  **粗体**      │   粗体             │
│ 📐 公式    │  $E=mc^2$     │   E=mc²           │
│ 📦 折叠框  │                │                    │
│ 📊 表格    │                │                    │
│ 🔗 链接    │                │                    │
│ 📚 模板    │                │                    │
│ 🛠️ 工具    │                │                    │
└─────────────────────────────────────────────────┘

✨ 特性

渲染对齐洛谷（精确到差异语料级别）

• 自研渲染器 严格对账 洛谷现行编辑器（remark/rehype + remark-gfm + remark-math + remark-directive 管线，见编辑器手册），57 例差分语料 57/57 一致
• KaTeX 公式三级匹配：块级 $$ / 整行 $$x$$ / 段内 $$x$$ 行内（与洛谷语义一致）
• GFM 全集：脚注 [^n]、裸 URL 自动链接（https://… / www.…）、单/双波浪删除线、任务列表、表格对齐、硬换行
• 洛谷扩展：:::info|success|warning|error 折叠框、:::align{}、:::epigraph[落款]、::cute-table{tuack|three}、Prism 代码高亮（未标注语言默认 C++）
• 滚动同步、行号锚点、data-src-line 双向定位

排版修复 + 风格 lint（可选启用）

• 对照洛谷题解排版建议：句末补「。」（逐行判定）、行尾空格剥除（两空格硬换行除外）、ASCII 括号→全角、半角标点规范化、中英文间空格……
• 一句一行友好：题解正文「一句一行」时每行末尾都补「。」（延续标点结尾行自动跳过）
• 完整 CRLF 兼容：answer 为 CRLF 的文档修复后换行风格原样保留

编辑器端

• 侧边栏工具箱：插入洛谷语法、模板、片段
• 编辑区 ↔ 预览区滚动同步（watchdog 防抖，用户滚动不会被打断）
• 预览与主题自适应（亮色/暗色）

🚀 快速开始

安装（vsix）

1. 从 Releases 下载最新 .vsix
2. VSCode Ctrl+Shift+P → Extensions: Install from VSIX... → 选中文件
3. 打开任意 .md → 编辑器右上角预览图标（👁）开启实时预览

侧边栏工具箱

左侧活动栏点洛谷图标即开格式工具箱：

🔧 从源码开发

git clone https://github.com/wudream813/LuoguMarkdownEditor-in-vscode.git
cd LuoguMarkdownEditor-in-vscode
code .   # F5 调试

打包（生成 luogu-markdown-editor-<ver>.vsix）：

npx @vscode/vsce package --no-dependencies

仓库结构

├── extension.js / lint.js / style-lint.js   ← 扩展主进程（编辑/修复/lint/命令）
├── export-render.js                          ← vsce 打包时静态展开 media/**/* 供 webview 加载
├── media/
│   ├── luogu-parser.js                       ← 自研 markdown renderer（行号锚点 + 洛谷扩展语法）
│   ├── preview.js / preview.css / styles.css ← webview 端预览渲染器与主题
│   ├── sidebar-icon.svg / icon.png           ← 活动栏/缩略图
│   ├── katex/                                ← 静态打包的 KaTeX（formula 本地冻结，用户离线可渲）
│   └── prism/                                ← 静态打包的 Prism（cpp 默认主题 + 行号/行高亮插件）
└── test-harness/                             ← 差分对账 + 回归（不进 vsix，开源供第三方复现）
    ├── ref-render.js                         ← 洛谷基准渲染链（unified+remark 全家桶+rehype-katex）
    ├── test-diff.js                          ← 57 例语料对账（我们 vs 洛谷基准）
    ├── test-bugsweep.js                      ← 45 项对抗（泄漏/URL/CJK/CRLF/ReDoS/XSS/幂等）
    ├── test-fix.js / test-style.js / test-v111.js  ← 40+58+特性回归
    └── test-scroll*.js                        ← 滚动同步 watchdog 契约

开源自检

cd test-harness && npm install
node test-diff.js      # 与洛谷基准对账 57/57
node test-bugsweep.js  # 对抗性自检 45 项
node test-fix.js       # 排版修复 42 项
node test-style.js     # 风格 lint 58 项
node test-v111.js      # v1.1.1 特性传承
node test-scroll.js; node test-scroll-reverse.js

⚠️ 与洛谷渲染的差异（已知超集，非差异）

未标注语言的代码块默认按 C++ 高亮 —— 手册明确写透明度超出裸 remark。详见差分语料中的 ACK 注释。

🤝 贡献

Issue / PR 欢迎。提交前请跑 test-harness/，渲染层改动需要差分对账回 0 分叉或书面承认的 ACK。

📝 许可证

MIT © 2026 wudream813