Hacktoberfest 2026: los issues que los mantenedores marcaron para octubre, abiertos y aptos para principiantes. Explorar issues de Hacktoberfest

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

Abierto Apto para principiantes
  • ¿Algo no está bien?
#23,704 0 comentarios 0 reacciones 0 asignados Ver en GitHub

Los mantenedores suelen responder en 1 día

Nadie ha tomado este issue todavía.

Evaluación

Dificultad
2/5
Tiempo estimado
1-3 horas
Aptitud para principiantes
77/100
Tipo de issue
Error
Claridad
Bien especificado
Estado de actividad
Activo
Stack tecnológico
markdown, react, typescript, yaml
Área
frontend, web-dev

Línea de trabajo

Empieza en la vista previa de Markdown de apps/web y sigue cómo renderiza el archivo proporcionado; el issue sugiere que la vista previa podría usar remark o react-markdown. Comprueba si el frontmatter de YAML se analiza antes del renderizado. La tarea estará terminada cuando la vista previa empiece en el encabezado del documento y el frontmatter esté oculto o se muestre como una tabla compacta de pares clave/valor.

Escrito por el modelo de indexación a partir del texto del issue.

Descripción

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.

Lenguaje dominante
TypeScript
Estrellas
24.8k
Forks
6.4k
Merge medio
1 h 22 min
PR fusionados (30 d)
18

Preparar el entorno

Abrir en Codespaces

Inicia el contenedor de desarrollo del proyecto en tu navegador, con tu propia cuenta de GitHub.

Primeros pasos

  1. Lee el issue completo y luego la guía de contribución del proyecto.
  2. Comenta en el issue que vas a ocuparte — evita que dos personas hagan lo mismo.
  3. Haz un fork del repositorio y trabaja en una rama.
  4. Abre un pull request que haga referencia al número del issue.

Más de pingdotgg/t3code

Todos los issues de pingdotgg/t3code

Issues similares

Más issues de TypeScript

Recibe los nuevos issues en tu correo

Un resumen breve de issues de GitHub para principiantes.