refactor: replace YAML front matter with title heading and metadata table

- Title is now a # heading at the top of the file
- Note body follows the title
- Metadata (ID, created, modified, account, shared) is rendered as a
  Markdown table at the bottom, separated by a horizontal rule
- Shared field shows "Yes"/"No" instead of true/false

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Author: PyAgni

internal/filesystem/writer.go

@@ -56,26 +56,23 @@ func NewFSNoteWriter(basePath, notesSubdir string, frontMatter bool, attachmentD
 	}
 }
 
-// frontMatterTemplate is the YAML front matter template for note files.
-var frontMatterTemplate = template.Must(template.New("frontmatter").Parse(`---
-title: "{{.Title}}"
-id: "{{.ID}}"
-created: {{.Created}}
-modified: {{.Modified}}
-account: "{{.Account}}"
-shared: {{.Shared}}
+// metadataTableTemplate renders a Markdown table with note metadata,
+// placed at the bottom of the file after a horizontal rule.
+var metadataTableTemplate = template.Must(template.New("metadata").Parse(`
 ---
 
+| ID | Created | Modified | Account | Shared |
+|----|---------|----------|---------|--------|
+| {{.ID}} | {{.Created}} | {{.Modified}} | {{.Account}} | {{.Shared}} |
 `))
 
-// frontMatterData holds the template data for front matter rendering.
-type frontMatterData struct {
-	Title    string
+// metadataData holds the template data for the metadata table.
+type metadataData struct {
 	ID       string
 	Created  string
 	Modified string
 	Account  string
-	Shared   bool
+	Shared   string
 }
 
 // notesDir returns the absolute path to the notes directory.
@@ -104,28 +101,38 @@ func (w *FSNoteWriter) WriteNote(ctx context.Context, note *model.Note) (string,
 	fileName := note.SanitizedFileName() + ".md"
 	fullPath := filepath.Join(dirPath, fileName)
 
-	// Build file content.
+	// Build file content: title heading, body, then metadata table at bottom.
 	var content strings.Builder
 
+	// Title as a top-level heading.
+	content.WriteString("# ")
+	content.WriteString(note.Name)
+	content.WriteString("\n\n")
+
+	// Note body.
+	content.WriteString(note.BodyMarkdown)
+
+	// Metadata table at the bottom after a divider.
 	if w.frontMatter {
-		data := frontMatterData{
-			Title:    escapeFrontMatterString(note.Name),
+		shared := "No"
+		if note.Shared {
+			shared = "Yes"
+		}
+		data := metadataData{
 			ID:       note.ID,
-			Created:  note.CreatedAt.Format("2006-01-02T15:04:05Z07:00"),
-			Modified: note.ModifiedAt.Format("2006-01-02T15:04:05Z07:00"),
+			Created:  note.CreatedAt.Format("2006-01-02 15:04:05"),
+			Modified: note.ModifiedAt.Format("2006-01-02 15:04:05"),
 			Account:  note.Account,
-			Shared:   note.Shared,
+			Shared:   shared,
 		}
 
 		var buf bytes.Buffer
-		if err := frontMatterTemplate.Execute(&buf, data); err != nil {
-			return "", fmt.Errorf("rendering front matter for %q: %w", note.Name, err)
+		if err := metadataTableTemplate.Execute(&buf, data); err != nil {
+			return "", fmt.Errorf("rendering metadata for %q: %w", note.Name, err)
 		}
 		content.WriteString(buf.String())
 	}
 
-	content.WriteString(note.BodyMarkdown)
-
 	if err := os.WriteFile(fullPath, []byte(content.String()), 0644); err != nil {
 		return "", fmt.Errorf("writing note file %q: %w", fullPath, err)
 	}
@@ -249,11 +256,6 @@ func (w *FSNoteWriter) SaveAttachment(ctx context.Context, notePath string, atta
 	return relPath, nil
 }
 
-// escapeFrontMatterString escapes double quotes in strings for YAML front matter.
-func escapeFrontMatterString(s string) string {
-	return strings.ReplaceAll(s, `"`, `\"`)
-}
-
 // removeEmptyDirs walks a directory tree bottom-up and removes empty directories.
 func removeEmptyDirs(root string) error {
 	return filepath.Walk(root, func(path string, info os.FileInfo, err error) error {

internal/filesystem/writer_test.go

@@ -45,10 +45,16 @@ func TestFSNoteWriter_WriteNote_BasicNote(t *testing.T) {
 	content, err := os.ReadFile(filepath.Join(base, relPath))
 	require.NoError(t, err)
 
-	assert.Contains(t, string(content), "---")
-	assert.Contains(t, string(content), `title: "My Note"`)
-	assert.Contains(t, string(content), `account: "iCloud"`)
-	assert.Contains(t, string(content), "Hello world")
+	s := string(content)
+	// Title as heading at the top.
+	assert.True(t, strings.HasPrefix(s, "# My Note\n"))
+	// Body content.
+	assert.Contains(t, s, "Hello world")
+	// Metadata table at the bottom with divider.
+	assert.Contains(t, s, "\n---\n")
+	assert.Contains(t, s, "| ID | Created | Modified | Account | Shared |")
+	assert.Contains(t, s, "| x-coredata://test-id |")
+	assert.Contains(t, s, "| iCloud |")
 }
 
 func TestFSNoteWriter_WriteNote_WithSubdir(t *testing.T) {
@@ -61,7 +67,7 @@ func TestFSNoteWriter_WriteNote_WithSubdir(t *testing.T) {
 	assert.Equal(t, filepath.Join("notes", "Work", "Test.md"), relPath)
 }
 
-func TestFSNoteWriter_WriteNote_NoFrontMatter(t *testing.T) {
+func TestFSNoteWriter_WriteNote_NoMetadata(t *testing.T) {
 	w, base := newTestWriter(t, "", false)
 
 	note := newTestNote("Simple", "Notes", "Just content\n")
@@ -71,8 +77,12 @@ func TestFSNoteWriter_WriteNote_NoFrontMatter(t *testing.T) {
 	content, err := os.ReadFile(filepath.Join(base, relPath))
 	require.NoError(t, err)
 
-	assert.NotContains(t, string(content), "---")
-	assert.Equal(t, "Just content\n", string(content))
+	s := string(content)
+	// Title heading is always present.
+	assert.True(t, strings.HasPrefix(s, "# Simple\n"))
+	assert.Contains(t, s, "Just content")
+	// No metadata table.
+	assert.NotContains(t, s, "| ID |")
 }
 
 func TestFSNoteWriter_WriteNote_NestedFolders(t *testing.T) {
@@ -199,25 +209,38 @@ func TestFSNoteWriter_SaveAttachment_NilData(t *testing.T) {
 	assert.Empty(t, relPath)
 }
 
-func TestEscapeFrontMatterString(t *testing.T) {
-	assert.Equal(t, `Hello \"World\"`, escapeFrontMatterString(`Hello "World"`))
-	assert.Equal(t, "No quotes", escapeFrontMatterString("No quotes"))
+func TestFSNoteWriter_WriteNote_MetadataTableContent(t *testing.T) {
+	w, base := newTestWriter(t, "", true)
+
+	note := newTestNote("My Title", "Notes", "Body\n")
+	note.Shared = true
+	relPath, err := w.WriteNote(context.Background(), &note)
+	require.NoError(t, err)
+
+	content, err := os.ReadFile(filepath.Join(base, relPath))
+	require.NoError(t, err)
+
+	s := string(content)
+	// Title heading at top.
+	assert.True(t, strings.HasPrefix(s, "# My Title\n"))
+	// Body before divider.
+	assert.Contains(t, s, "Body\n")
+	// Metadata table with correct values.
+	assert.Contains(t, s, "2026-03-18 16:00:00")
+	assert.Contains(t, s, "2026-03-18 17:00:00")
+	assert.Contains(t, s, "| iCloud |")
+	assert.Contains(t, s, "| Yes |")
 }
 
-func TestFSNoteWriter_WriteNote_FrontMatterContent(t *testing.T) {
+func TestFSNoteWriter_WriteNote_MetadataSharedNo(t *testing.T) {
 	w, base := newTestWriter(t, "", true)
 
-	note := newTestNote("Title With \"Quotes\"", "Notes", "Body\n")
+	note := newTestNote("Test", "Notes", "Content\n")
 	relPath, err := w.WriteNote(context.Background(), &note)
 	require.NoError(t, err)
 
 	content, err := os.ReadFile(filepath.Join(base, relPath))
 	require.NoError(t, err)
 
-	s := string(content)
-	assert.True(t, strings.HasPrefix(s, "---\n"))
-	assert.Contains(t, s, `title: "Title With \"Quotes\""`)
-	assert.Contains(t, s, "created: 2026-03-18T16:00:00Z")
-	assert.Contains(t, s, "modified: 2026-03-18T17:00:00Z")
-	assert.Contains(t, s, "shared: false")
+	assert.Contains(t, string(content), "| No |")
 }