feat: support custom dataview link text

Author: arkan

docs/dataview.md

@@ -23,6 +23,15 @@ FROM "Projects"
 SORT file.name
 ```
 
+Use `link(file.path, title)` when you want a clickable note link whose visible
+text comes from frontmatter instead of the file name:
+
+```dataview
+TABLE link(file.path, title) AS "Name", status
+FROM "Projects"
+SORT file.name
+```
+
 ### FILTER clause
 
 Add interactive column dropdown filters to any `TABLE` query:

internal/app/dataview.go

@@ -4,6 +4,7 @@ import (
 	"fmt"
 	"html"
 	"html/template"
+	"net/url"
 	"path/filepath"
 	"regexp"
 	"sort"
@@ -631,6 +632,11 @@ func evalFunc(r dataviewRow, name string, args []string) any {
 			txt := displayPlain(evalValue(r, args[0]))
 			return dataviewLink{URL: "#", Text: txt}
 		}
+		if len(args) == 2 {
+			target := displayPlain(evalValue(r, args[0]))
+			text := displayPlain(evalValue(r, args[1]))
+			return dataviewLink{URL: dataviewLinkURL(target), Text: text}
+		}
 	case "dur", "duration":
 		if len(args) == 1 {
 			return parseDataviewDuration(args[0])
@@ -834,6 +840,21 @@ func noteFileName(n NoteMeta) string {
 	return strings.TrimSuffix(filepath.Base(n.RelPath), filepath.Ext(n.RelPath))
 }
 
+func dataviewLinkURL(target string) string {
+	target = strings.TrimSpace(target)
+	if target == "" {
+		return "#"
+	}
+	if strings.HasPrefix(target, "http://") || strings.HasPrefix(target, "https://") || strings.HasPrefix(target, "/") || strings.HasPrefix(target, "#") {
+		return target
+	}
+	parts := strings.Split(filepath.ToSlash(target), "/")
+	for i, part := range parts {
+		parts[i] = url.PathEscape(part)
+	}
+	return "/" + strings.Join(parts, "/")
+}
+
 type dataviewLink struct{ URL, Text string }
 
 func renderDataviewTable(q dataviewQuery, rows []dataviewRow) template.HTML {

internal/app/dataview_test.go

@@ -81,6 +81,22 @@ func TestDataviewMultilineTableColumns(t *testing.T) {
 	}
 }
 
+func TestDataviewLinkFunctionUsesCustomText(t *testing.T) {
+	v := makeDataviewVault(t)
+	html := string(RenderDataviewBlock(v, `TABLE link(file.path, title) AS "Project"
+FROM "Projects"
+WHERE status = "active"
+SORT file.name`))
+	for _, want := range []string{`href="/Projects/Alpha.md">Alpha Project</a>`, `href="/Projects/Gamma.md">Gamma Project</a>`} {
+		if !strings.Contains(html, want) {
+			t.Fatalf("custom link table missing %q in:\n%s", want, html)
+		}
+	}
+	if strings.Contains(html, `href="#">Alpha Project</a>`) || strings.Contains(html, `>Alpha</a>`) {
+		t.Fatalf("custom link should use file path URL and title text:\n%s", html)
+	}
+}
+
 func TestDataviewWhereLimitTagSourceFunctionsAndYamlLists(t *testing.T) {
 	v := makeDataviewVault(t)
 	query := `TABLE file.link as "Note", default(area, "none") as "Area", length(aliases) as "Aliases", choice(score >= 9, "high", "normal") as "Tier"