From 35a52dd26034b81637fc9c751f00f73bf8281dcc Mon Sep 17 00:00:00 2001
From: Liang Ding <d@b3log.org>
Date: Tue, 21 Mar 2023 11:52:13 +0800
Subject: [PATCH] =?UTF-8?q?:art:=20=E5=AF=BC=E5=87=BA=20Markdown=20?=
 =?UTF-8?q?=E6=97=B6=E5=9C=A8=E6=96=87=E6=A1=A3=E5=A4=B4=E6=B7=BB=E5=8A=A0?=
 =?UTF-8?q?=20YFM=20=E5=BC=80=E5=85=B3=20https://github.com/siyuan-note/si?=
 =?UTF-8?q?yuan/issues/7727?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 app/appearance/langs/en_US.json  | 2 ++
 app/appearance/langs/es_ES.json  | 2 ++
 app/appearance/langs/fr_FR.json  | 2 ++
 app/appearance/langs/zh_CHT.json | 2 ++
 app/appearance/langs/zh_CN.json  | 2 ++
 app/src/config/exportConfig.ts   | 9 +++++++++
 app/src/types/index.d.ts         | 1 +
 kernel/conf/export.go            | 2 ++
 kernel/model/export.go           | 4 ++++
 9 files changed, 26 insertions(+)

diff --git a/app/appearance/langs/en_US.json b/app/appearance/langs/en_US.json
index 54dcc76d2..7cce4bd06 100644
--- a/app/appearance/langs/en_US.json
+++ b/app/appearance/langs/en_US.json
@@ -718,6 +718,8 @@
   "export20": "Exporting Word .docx files requires format conversion using <a href=\"https://pandoc.org\" target=\"_blank\">Pandoc</a>",
   "export21": "Export PDF with footer",
   "export22": "After enabling, add <code class='fn__code'>Export by SiYuan</code> at the footer of the exported PDF",
+  "export23": "Export Markdown wit YFM",
+  "export24": "After enabling, add some general metadata information at the beginning of the exported Markdown file",
   "blockRef": "Ref Block",
   "theme11": "Use theme in light mode",
   "theme12": "Use theme in dark mode",
diff --git a/app/appearance/langs/es_ES.json b/app/appearance/langs/es_ES.json
index 6000987df..e753ef690 100644
--- a/app/appearance/langs/es_ES.json
+++ b/app/appearance/langs/es_ES.json
@@ -718,6 +718,8 @@
   "export20": "La exportación de archivos Word .docx requiere la conversión del formato mediante <a href=\"https://pandoc.org\" target=\"_blank\">Pandoc</a>",
   "export21": "Exportar PDF con pie de página",
   "export22": "Después de habilitar, agregue <code class='fn__code'>Exportar por SiYuan</code> al pie de página del PDF exportado",
+  "export23": "Exportar descuento con YFM",
+  "export24": "Después de habilitar, agregue información general de metadatos al comienzo del archivo Markdown exportado",
   "blockRef": "Bloque de referencia",
   "theme11": "Usar tema en modo claro",
   "theme12": "Usar tema en modo oscuro",
diff --git a/app/appearance/langs/fr_FR.json b/app/appearance/langs/fr_FR.json
index 697058ded..b7a8c6ac1 100644
--- a/app/appearance/langs/fr_FR.json
+++ b/app/appearance/langs/fr_FR.json
@@ -718,6 +718,8 @@
   "export20": "L'exportation de fichiers Word .docx nécessite une conversion de format à l'aide de <a href=\"https://pandoc.org\" target=\"_blank\">Pandoc</a>",
   "export21": "Exporter un PDF avec pied de page",
   "export22": "Après l'activation, ajoutez <code class='fn__code'>Exporter par SiYuan</code> au pied de page du PDF exporté",
+  "export23": "Exporter Markdown avec YFM",
+  "export24": "Après l'activation, ajoutez des informations générales sur les métadonnées au début du fichier Markdown exporté",
   "blockRef": "Bloc Réf",
   "theme11": "Utiliser le thème en mode Clair",
   "theme12": "Utiliser le thème en mode sombre",
diff --git a/app/appearance/langs/zh_CHT.json b/app/appearance/langs/zh_CHT.json
index 540e1eeb8..e884dcc26 100644
--- a/app/appearance/langs/zh_CHT.json
+++ b/app/appearance/langs/zh_CHT.json
@@ -718,6 +718,8 @@
   "export20": "導出 Word .docx 文件需要使用 <a href=\"https://pandoc.org\" target=\"_blank\">Pandoc</a> 進行格式轉換",
   "export21": "導出 PDF 添加頁腳",
   "export22": "開啟後在導出的 PDF 頁腳處添加 <code class='fn__code'>由思源筆記導出</code>",
+  "export23": "導出 Markdown 添加 YFM",
+  "export24": "啟用後在導出的 Markdown 文件開頭處添加一些較為通用的元數據信息",
   "blockRef": "引用塊",
   "theme11": "淺色模式下使用主題",
   "theme12": "深色模式下使用主題",
diff --git a/app/appearance/langs/zh_CN.json b/app/appearance/langs/zh_CN.json
index ba05194e6..167c32fd7 100644
--- a/app/appearance/langs/zh_CN.json
+++ b/app/appearance/langs/zh_CN.json
@@ -718,6 +718,8 @@
   "export20": "导出 Word .docx 文件需要使用 <a href=\"https://pandoc.org\" target=\"_blank\">Pandoc</a> 进行格式转换",
   "export21": "导出 PDF 添加页脚",
   "export22": "启用后在导出的 PDF 页脚处添加 <code class='fn__code'>由思源笔记导出</code>",
+  "export23": "导出 Markdown 添加 YFM",
+  "export24": "启用后在导出的 Markdown 文件开头处添加一些较为通用的元数据信息",
   "blockRef": "引用块",
   "theme11": "明亮模式下使用主题",
   "theme12": "暗黑模式下使用主题",
diff --git a/app/src/config/exportConfig.ts b/app/src/config/exportConfig.ts
index bb7f49a3a..59201b309 100644
--- a/app/src/config/exportConfig.ts
+++ b/app/src/config/exportConfig.ts
@@ -35,6 +35,14 @@ export const exportConfig = {
     <span class="fn__space"></span>
     <input class="b3-switch fn__flex-center" id="addFooter" type="checkbox"${window.siyuan.config.export.addFooter ? " checked" : ""}/>
 </label>
+<label class="fn__flex b3-label">
+    <div class="fn__flex-1">
+        ${window.siyuan.languages.export23}
+        <div class="b3-label__text">${window.siyuan.languages.export24}</div>
+    </div>
+    <span class="fn__space"></span>
+    <input class="b3-switch fn__flex-center" id="markdownYFM" type="checkbox"${window.siyuan.config.export.markdownYFM ? " checked" : ""}/>
+</label>
 <label class="fn__flex b3-label config__item">
     <div class="fn__flex-1">
         ${window.siyuan.languages.blockRef}
@@ -130,6 +138,7 @@ export const exportConfig = {
                 paragraphBeginningSpace: (exportConfig.element.querySelector("#paragraphBeginningSpace") as HTMLInputElement).checked,
                 addTitle: (exportConfig.element.querySelector("#addTitle") as HTMLInputElement).checked,
                 addFooter: (exportConfig.element.querySelector("#addFooter") as HTMLInputElement).checked,
+                markdownYFM: (exportConfig.element.querySelector("#markdownYFM") as HTMLInputElement).checked,
                 blockRefMode: parseInt((exportConfig.element.querySelector("#blockRefMode") as HTMLSelectElement).value, 10),
                 blockEmbedMode: parseInt((exportConfig.element.querySelector("#blockEmbedMode") as HTMLSelectElement).value, 10),
                 fileAnnotationRefMode: parseInt((exportConfig.element.querySelector("#fileAnnotationRefMode") as HTMLSelectElement).value, 10),
diff --git a/app/src/types/index.d.ts b/app/src/types/index.d.ts
index b5e3b8664..fc4570115 100644
--- a/app/src/types/index.d.ts
+++ b/app/src/types/index.d.ts
@@ -306,6 +306,7 @@ declare interface IExport {
     paragraphBeginningSpace: boolean;
     addTitle: boolean;
     addFooter: boolean;
+    markdownYFM: boolean;
 }
 
 declare interface IEditor {
diff --git a/kernel/conf/export.go b/kernel/conf/export.go
index 20652526e..14e3054bb 100644
--- a/kernel/conf/export.go
+++ b/kernel/conf/export.go
@@ -28,6 +28,7 @@ type Export struct {
 	TagCloseMarker          string `json:"tagCloseMarker"`          // 标签结束标记符，默认是 #
 	FileAnnotationRefMode   int    `json:"fileAnnotationRefMode"`   // 文件标注引用导出模式，0：文件名 - 页码 - 锚文本，1：仅锚文本
 	PandocBin               string `json:"pandocBin"`               // Pandoc 可执行文件路径
+	MarkdownYFM             bool   `json:"markdownYFM"`             // Markdown 导出时是否添加 YAML Front Matter https://github.com/siyuan-note/siyuan/issues/7727
 }
 
 func NewExport() *Export {
@@ -43,5 +44,6 @@ func NewExport() *Export {
 		TagCloseMarker:          "#",
 		FileAnnotationRefMode:   0,
 		PandocBin:               "",
+		MarkdownYFM:             false,
 	}
 }
diff --git a/kernel/model/export.go b/kernel/model/export.go
index 0eda744b6..f68a08dbe 100644
--- a/kernel/model/export.go
+++ b/kernel/model/export.go
@@ -1165,6 +1165,10 @@ func exportMarkdownZip(boxID, baseFolderName string, docPaths []string) (zipPath
 
 func yfm(docIAL map[string]string) string {
 	// 导出 Markdown 文件时开头附上一些元数据 https://github.com/siyuan-note/siyuan/issues/6880
+	// 导出 Markdown 时在文档头添加 YFM 开关https://github.com/siyuan-note/siyuan/issues/7727
+	if !Conf.Export.MarkdownYFM {
+		return ""
+	}
 
 	buf := bytes.Buffer{}
 	buf.WriteString("---\n")