imfing · davlgd · Sep 13, 2025 · Sep 13, 2025
diff --git a/docs/content/docs/guide/configuration.fa.md b/docs/content/docs/guide/configuration.fa.md
@@ -394,9 +394,11 @@ params:
 ```diff {filename="hugo.yaml"}
 outputs:
 - home: [html]
+- page: [html]
+- section: [html, rss]
 + home: [html, llms]
-  page: [html]
-  section: [html, rss]
++ page: [html, markdown]
++ section: [html, markdown, rss]
 ```
 
 این کار یک فایل `llms.txt` در ریشه سایت شما ایجاد می‌کند که شامل:

diff --git a/docs/content/docs/guide/configuration.ja.md b/docs/content/docs/guide/configuration.ja.md
@@ -394,17 +394,19 @@ params:
 ```diff {filename="hugo.yaml"}
 outputs:
 - home: [html]
+- page: [html]
+- section: [html, rss]
 + home: [html, llms]
-  page: [html]
-  section: [html, rss]
++ page: [html, markdown]
++ section: [html, markdown, rss]
 ```
 
 これにより、サイトのルートに `llms.txt` ファイルが生成され、以下が含まれます：
 
 - サイトタイトルと説明
 - すべてのセクションとページの階層リスト
 - ページの要約と公開日
-- すべてのコンテンツへの直接リンク
+- すべてのコンテンツへの直接リンク（Markdown形式）
 
 llms.txt ファイルはコンテンツ構造から自動生成され、AI ツールや言語モデルがコンテキストや参照のためにあなたのサイトにアクセスしやすくします。
 

diff --git a/docs/content/docs/guide/configuration.md b/docs/content/docs/guide/configuration.md
@@ -455,17 +455,19 @@ To enable [llms.txt](https://llmstxt.org/) output format for your site, which pr
 ```diff {filename="hugo.yaml"}
 outputs:
 - home: [html]
+- page: [html]
+- section: [html, rss]
 + home: [html, llms]
-  page: [html]
-  section: [html, rss]
++ page: [html, markdown]
++ section: [html, markdown, rss]
 ```
 
 This will generate an `llms.txt` file at your site's root containing:
 
 - Site title and description
 - Hierarchical listing of all sections and pages
 - Page summaries and publication dates
-- Direct links to all content
+- Direct links to all content in markdown format
 
 The llms.txt file is automatically generated from your content structure and makes your site more accessible to AI tools and language models for context and reference.
 

diff --git a/docs/content/docs/guide/configuration.zh-cn.md b/docs/content/docs/guide/configuration.zh-cn.md
@@ -394,17 +394,19 @@ params:
 ```diff {filename="hugo.yaml"}
 outputs:
 - home: [html]
+- page: [html]
+- section: [html, rss]
 + home: [html, llms]
-  page: [html]
-  section: [html, rss]
++ page: [html, markdown]
++ section: [html, markdown, rss]
 ```
 
 这将在站点根目录生成一个 `llms.txt` 文件，包含：
 
 - 站点标题和描述
 - 所有章节和页面的层次结构列表
 - 页面摘要和发布日期
-- 所有内容的直接链接
+- 所有内容的直接链接（Markdown格式）
 
 llms.txt 文件根据内容结构自动生成，使 AI 工具和语言模型更容易获取上下文和参考。
 

diff --git a/docs/hugo.yaml b/docs/hugo.yaml
@@ -14,8 +14,8 @@ hasCJKLanguage: true
 
 outputs:
   home: [html, llms]
-  page: [html]
-  section: [html, rss]
+  page: [html, markdown]
+  section: [html, markdown, rss]
 
 defaultContentLanguage: en
 languages:

diff --git a/hugo.toml b/hugo.toml
@@ -8,3 +8,6 @@
     baseName = 'llms'
     mediaType = 'text/plain'
     isPlainText = true
+  [outputFormats.markdown]
+    name = 'Markdown'
+    baseName = 'index.html'
diff --git a/layouts/list.md b/layouts/list.md
@@ -0,0 +1,2 @@
+# {{ .Title }}
+{{ .RawContent | htmlUnescape }}
diff --git a/layouts/llms.txt b/layouts/llms.txt
@@ -2,35 +2,60 @@
 
 > {{ .Site.Params.description }}
 
-{{ range $section := site.Sections }}
-{{- template "llms-section-tree" dict "context" . "level" 2 }}
-{{ end }}
-
-{{- $rootPages := where site.RegularPages "Section" "" }}
-{{- if $rootPages }}
+{{- if and (not .Params.llmstxt.optional) (gt (len .Pages) 0) }}
+{{- range .Site.Sections }}
+{{- if and (not .Params.llmstxt.optional) (not .Params.llmstxt.exclude) }}
+{{- $allSections := slice . -}}
+{{- range .Sections -}}
+{{- if and (not .Params.llmstxt.optional) (not .Params.llmstxt.exclude) -}}
+{{- $allSections = $allSections | append . -}}
+{{- end -}}
+{{- end -}}
+{{- range $allSections }}
 
-## Root Pages
-{{- range $rootPages }}
-- [{{ .Title }}]({{ .Permalink }}): {{ .Summary | plainify | truncate 100 | strings.TrimSpace }}{{ if .Date }} - Published {{ .Date.Format "2006-01-02" }}{{ end }}
+## {{ .Title }}
+{{- range .Pages }}
+{{- if not .Params.llmstxt.exclude }}
+- [{{ .Title }}]({{ .Permalink }}index.html.md): {{ .Summary | plainify | truncate 100 | strings.TrimSpace }}{{ if .Date }} - Published {{ .Date.Format "2006-01-02" }}{{ end }}
+{{- end }}
+{{- end }}
+{{- end }}
 {{- end }}
 {{- end }}
 
----
-Generated on {{ now.Format "2006-01-02 15:04:05 UTC" }}
-Site: {{ .Site.BaseURL }}
+{{- $optionalPages := slice }}
+{{- range .Site.Sections }}
+{{- if and .Params.llmstxt.optional (not .Params.llmstxt.exclude) }}
+{{- range .Pages }}
+{{- if not .Params.llmstxt.exclude }}
+{{- $optionalPages = $optionalPages | append . }}
+{{- end }}
+{{- end }}
+{{- end }}
+{{- range .Sections }}
+{{- if and .Params.llmstxt.optional (not .Params.llmstxt.exclude) }}
+{{- range .Pages }}
+{{- if not .Params.llmstxt.exclude }}
+{{- $optionalPages = $optionalPages | append . }}
+{{- end }}
+{{- end }}
+{{- end }}
+{{- end }}
+{{- end }}
 
-{{- define "llms-section-tree" -}}
-{{- $context := .context -}}
-{{- $level := .level | default 2 -}}
-{{- $headerHashes := strings.Repeat $level "#" -}}
-{{- "\n" -}}
-{{ $headerHashes }} {{ $context.Title }}
+{{- if gt (len $optionalPages) 0 }}
 
-{{- range $context.RegularPages }}
-- [{{ .Title }}]({{ .Permalink }}): {{ .Summary | plainify | truncate 100 | strings.TrimSpace }}{{ if .Date }} - Published {{ .Date.Format "2006-01-02" }}{{ end }}
+## Optional
+{{- range $optionalPages }}
+- [{{ .Title }}]({{ .Permalink }}index.html.md){{ with .Description }}: {{ . }}{{ else }}{{ with .Summary }}: {{ . | plainify | truncate 100 | strings.TrimSpace }}{{ end }}{{ end }}
 {{- end }}
-
-{{- range $context.Sections }}
-{{ template "llms-section-tree" dict "context" . "level" (add $level 1) }}
 {{- end }}
+{{- else -}}
+{{- .RawContent | .Page.RenderString -}}
 {{- end -}}
+{{- "\n" -}}
+{{- "\n" -}}
+
+---
+Generated on {{ now.Format "2006-01-02 15:04:05 UTC" }}
+Site: {{ .Site.BaseURL }}
diff --git a/layouts/single.md b/layouts/single.md
@@ -0,0 +1,2 @@
+# {{ .Title }}
+{{ .RawContent | htmlUnescape }}
Original file line number	Diff line number	Diff line change
		@@ -0,0 +1,2 @@
		# {{ .Title }}
		{{ .RawContent \| htmlUnescape }}