Hacktoberfest 2026: le issue che i maintainer hanno segnato per ottobre, aperte e adatte ai principianti. Sfoglia le issue Hacktoberfest

[Bug]: Markdown file preview renders YAML frontmatter as a setext heading

Chiusa Adatta ai principianti
  • Qualcosa non va?
#23,704 0 commenti 0 reazioni 0 assegnatari Vedi su GitHub

I maintainer di solito rispondono entro 1 giorno

Una pull request collegata è già stata integrata.

  • #23914 di @juliusmarminge — chiusa senza merge
  • #25804 di @t3dotgg — integrata

Valutazione

Difficoltà
2/5
Tempo stimato
1-3 ore
Idoneità per principianti
77/100
Tipo di issue
Bug
Chiarezza
Specificata chiaramente
Stato di attività
Attiva
Stack tecnologico
markdown, react, typescript, yaml
Ambito
frontend, web-dev

Direzione di ricerca

Inizia dall’anteprima Markdown in apps/web e segui il modo in cui visualizza il file fornito; l’issue suggerisce che l’anteprima potrebbe usare remark o react-markdown. Verifica se il frontmatter YAML viene analizzato prima del rendering. Il lavoro è completato quando l’anteprima inizia dal titolo del documento e il frontmatter è nascosto oppure mostrato come tabella compatta chiave/valore.

Scritto dal modello di indicizzazione a partire dal testo della issue.

Descrizione

Before submitting
  • I searched existing issues and did not find a duplicate.
  • I included enough detail to reproduce or investigate the problem.
Area

apps/web

Steps to reproduce

  1. Open a project that has a Markdown file starting with YAML frontmatter, for example:

    ---
type: Task
title: Decide the joke source and Draft safety limits
description: Settle where Jokes come from and what a Draft may never contain.
status: draft
task_status: ready
blocked_by: []
created: 2026-10-22
---

# Decide the joke source and Draft safety limits

  2. Open that file from the Files panel so it shows in the rendered Markdown preview.

Expected behavior

The frontmatter block is recognised as metadata. It is either hidden or shown as a small key/value table, the way GitHub, GitLab and Obsidian render it. The document starts at the # heading.

Actual behavior

The frontmatter is rendered as ordinary Markdown:

  • The opening --- becomes a horizontal rule.
  • All the YAML lines collapse into one paragraph (type: Task title: … created: 2026-10-22).
  • The closing --- under that paragraph turns it into a setext H2.

So every file with frontmatter opens with a large bold run-on "heading" made of its metadata.

Impact

Minor bug or occasional failure

Version or commit

T3 Code (Beta) desktop 0.1.0

Environment

macOS 27 (Darwin 27.0.0), T3 Code desktop app

Workaround

Switch the file tab to source view, or open the file in an external editor.

Context

We keep project knowledge as Markdown files with YAML frontmatter, using the OKF v0.2 convention: every page carries type, title, description and status, and Task pages also carry Board fields such as task_status and blocked_by. Agents and humans read these files side by side in T3 Code. Frontmatter is also standard in Obsidian vaults, static-site generators and agent skill files (SKILL.md), so most Markdown in agent-driven repositories hits this.

A likely fix: enable frontmatter parsing in the Markdown preview (for example remark-frontmatter, if the preview uses remark/react-markdown), then hide the block or render it as a compact properties table.

Lingua principale
TypeScript
Stelle
24.8k
Fork
6.4k
Merge medio
2h 48m
PR unite (30g)
353

Preparare l'ambiente

Apri in Codespaces

Avvia il container di sviluppo del progetto nel browser, con il tuo account GitHub.

Come iniziare

  1. Leggi tutta la issue e poi la guida ai contributi del progetto.
  2. Commenta sulla issue per dire che te ne occupi tu — evita che due persone facciano lo stesso lavoro.
  3. Fai un fork del repository e lavora su un branch.
  4. Apri una pull request che faccia riferimento al numero della issue.

Altre issue di pingdotgg/t3code

Tutte le issue di pingdotgg/t3code

Issue simili

Altre issue su TypeScript

Ricevi le nuove issue nella tua casella

Un breve riepilogo di issue GitHub adatte ai principianti.