go-gitea · silverwind · Apr 17, 2026 · Apr 15, 2026 · Apr 15, 2026 · Apr 15, 2026
diff --git a/modules/markup/external/external.go b/modules/markup/external/external.go
@@ -22,6 +22,7 @@ import (
 // RegisterRenderers registers all supported third part renderers according settings
 func RegisterRenderers() {
 	markup.RegisterRenderer(&openAPIRenderer{})
+	markup.RegisterRenderer(&viewer3dRenderer{})
 	for _, renderer := range setting.ExternalMarkupRenderers {
 		markup.RegisterRenderer(&Renderer{renderer})
 	}

diff --git a/modules/markup/external/viewer3d.go b/modules/markup/external/viewer3d.go
@@ -0,0 +1,79 @@
+// Copyright 2026 The Gitea Authors. All rights reserved.
+// SPDX-License-Identifier: MIT
+
+package external
+
+import (
+	"encoding/base64"
+	"fmt"
+	"html"
+	"io"
+	"path"
+
+	"code.gitea.io/gitea/modules/markup"
+	"code.gitea.io/gitea/modules/public"
+	"code.gitea.io/gitea/modules/setting"
+)
+
+type viewer3dRenderer struct{}
+
+var (
+	_ markup.PostProcessRenderer = (*viewer3dRenderer)(nil)
+	_ markup.ExternalRenderer    = (*viewer3dRenderer)(nil)
+)
+
+func (p *viewer3dRenderer) Name() string {
+	return "viewer3d"
+}
+
+func (p *viewer3dRenderer) NeedPostProcess() bool {
+	return false
+}
+
+func (p *viewer3dRenderer) FileNamePatterns() []string {
+	return []string{
+		"*.3dm", "*.3ds", "*.3mf", "*.amf", "*.bim", "*.brep",
+		"*.dae", "*.fbx", "*.fcstd", "*.glb", "*.gltf",
+		"*.ifc", "*.igs", "*.iges", "*.stp", "*.step",
+		"*.stl", "*.obj", "*.off", "*.ply", "*.wrl",
+	}
+}
+
+func (p *viewer3dRenderer) SanitizerRules() []setting.MarkupSanitizerRule {
+	return nil
+}
+
+func (p *viewer3dRenderer) GetExternalRendererOptions() (ret markup.ExternalRendererOptions) {
+	ret.SanitizerDisabled = true
+	ret.DisplayInIframe = true
+	ret.ContentSandbox = "allow-scripts"
+	return ret
+}
+
+func (p *viewer3dRenderer) Render(ctx *markup.RenderContext, input io.Reader, output io.Writer) error {
+	if ctx.RenderOptions.StandalonePageOptions == nil {
+		opts := p.GetExternalRendererOptions()
+		return markup.RenderIFrame(ctx, &opts, output)
+	}
+
+	if _, err := fmt.Fprintf(output,
+		`<!DOCTYPE html>
+<html>
+<head><meta charset="utf-8"><style>html,body{margin:0;height:100%%}#viewer{width:100%%;height:100%%}#viewer>div{text-align:center;padding:1em}</style></head>
+<body><div id="viewer"></div><script type="application/octet-stream" id="modelData" data-filename="%s">`,
+		html.EscapeString(path.Base(ctx.RenderOptions.RelativePath)),
+	); err != nil {
+		return err
+	}
+
+	b64 := base64.NewEncoder(base64.StdEncoding, output)
+	if _, err := io.Copy(b64, io.LimitReader(input, setting.UI.MaxDisplayFileSize)); err != nil {
+		return err
+	}
+	if err := b64.Close(); err != nil {
+		return err
+	}
+
+	_, err := fmt.Fprintf(output, `</script><script type="module" src="%s"></script></body></html>`, public.AssetURI("js/viewer-3d.js"))
+	return err
+}
diff --git a/vite.config.ts b/vite.config.ts
@@ -254,6 +254,7 @@ export default defineConfig(commonViteOpts({
       input: {
         index: join(import.meta.dirname, 'web_src/js/index.ts'),
         swagger: join(import.meta.dirname, 'web_src/js/swagger.ts'),
+        'viewer-3d': join(import.meta.dirname, 'web_src/js/viewer-3d.ts'),
         'eventsource.sharedworker': join(import.meta.dirname, 'web_src/js/eventsource.sharedworker.ts'),
         devtest: join(import.meta.dirname, 'web_src/css/devtest.css'),
         ...themes,

diff --git a/web_src/js/features/file-view.ts b/web_src/js/features/file-view.ts
@@ -1,5 +1,4 @@
 import type {FileRenderPlugin} from '../render/plugin.ts';
-import {newRenderPlugin3DViewer} from '../render/plugins/3d-viewer.ts';
 import {newRenderPluginPdfViewer} from '../render/plugins/pdf-viewer.ts';
 import {registerGlobalInitFunc} from '../modules/observer.ts';
 import {createElementFromHTML, showElem, toggleElemClass} from '../utils/dom.ts';
@@ -10,7 +9,7 @@ const plugins: FileRenderPlugin[] = [];
 
 function initPluginsOnce(): void {
   if (plugins.length) return;
-  plugins.push(newRenderPlugin3DViewer(), newRenderPluginPdfViewer());
+  plugins.push(newRenderPluginPdfViewer());
 }
 
 function findFileRenderPlugin(filename: string, mimeType: string): FileRenderPlugin | null {

diff --git a/web_src/js/render/plugins/3d-viewer.ts b/web_src/js/render/plugins/3d-viewer.ts
diff --git a/web_src/js/viewer-3d.ts b/web_src/js/viewer-3d.ts
@@ -0,0 +1,13 @@
+import * as OV from 'online-3d-viewer';
+
+const modelDataScript = document.querySelector<HTMLElement>('#modelData')!;
+const fileName = modelDataScript.getAttribute('data-filename')!;
+const fileBytes = Uint8Array.from(atob(modelDataScript.textContent), (c) => c.charCodeAt(0));
+
+const container = document.querySelector<HTMLElement>('#viewer')!;
+const viewer = new OV.EmbeddedViewer(container, {
+  backgroundColor: new OV.RGBAColor(59, 68, 76, 0),
+  defaultColor: new OV.RGBColor(65, 131, 196),
+  edgeSettings: new OV.EdgeSettings(false, new OV.RGBColor(0, 0, 0), 1),
+});
+viewer.LoadModelFromFileList([new File([fileBytes], fileName)]);