嘿，我来帮你搞定这个问题！GitLab的外部Wiki选项确实在后续版本里有调整，但咱们有更实用的替代方案，同时也能解决HTML转Markdown的需求：

一、在GitLab部署HTML文档的最优方案：GitLab Pages #

GitLab Pages是专门托管静态网页的功能，完美适配dartdoc生成的HTML文档，还能通过CI/CD自动构建部署，完全不用手动把HTML文件塞进项目仓库。具体步骤如下：

1. 创建CI/CD配置文件
   在你的Dart项目根目录下新建.gitlab-ci.yml文件，粘贴以下配置：

stages:
  - deploy

pages:
  stage: deploy
  image: dart:stable
  script:
    # 安装项目依赖（如果需要）
    - dart pub get
    # 生成HTML文档到public目录（GitLab Pages要求的默认输出目录）
    - dart doc --output public
  artifacts:
    paths:
      - public
  only:
    # 指定触发部署的分支，比如只在main分支更新时执行
    - main

2. 提交配置并触发部署
   把这个配置文件提交到GitLab仓库，GitLab会自动启动CI流水线，执行dartdoc生成文档并将产物放到public目录。完成后你就能通过https://<你的用户名>.gitlab.io/<你的项目名>/访问文档了。

3. 调整访问权限
   如果你的项目是私有仓库，可以在GitLab项目的「Settings」→「Pages」里设置文档的访问权限（比如内部可见、私有可见），确保只有授权用户能查看。

二、HTML转Markdown的便捷方法 #

其实你完全不用先生成HTML再转换——dartdoc本身就支持直接生成Markdown文档！只需要在运行命令时加上--format markdown参数：

dart doc --format markdown --output docs

这样会直接在docs目录下生成Markdown格式的文档，你可以把这个目录提交到仓库，GitLab会自动渲染Markdown内容，直接在仓库的「Wiki」或者文档目录里展示。

如果已经有现成的HTML文档需要转换，推荐用pandoc这个工具，它支持多种格式转换，命令非常简单：

pandoc -s your-dartdoc-html-file.html -o output.md

你还可以根据需求调整参数，处理样式、链接等细节。

内容的提问来源于stack exchange，提问作者Isymap_prog