Skip to content

Markdown for workflow preview #966

Open

Description

@sosensible

It seems we would use MarkDown for preview. So as we move through the flow, /specify > /plan > /tasks ... we have all these MarkDown docs, that do not properly preview in VSCode as the content is held in a mdc code block. This makes the doc not preview friendly.

One of the goals here is to practice good project workflow. If the artifacts are harder to read, the number of devs who actually take time to read will be lower.

Activity

  1. bkowshik commented on Mar 10, 2026

    @bkowshik

    +1

    Instead of an extention, I think we should have this as part of the spec-kit project itself.

    Example

    Below is how the Markdown looks like in code mode.

    Image

    And, below is how it looks in preview mode.

    Image
  2. mnriem commented on Mar 10, 2026

    @mnriem
    Collaborator

    @sosensible @bkowshik Feel free to create a PR for this :)

  3. github-actions commented on Aug 8, 2026

    @github-actions
    Contributor

    This issue has been automatically marked as stale because it has not had any activity for 150 days. It will be closed in 30 days if no further activity occurs.

  4. anetrebskii commented on Aug 8, 2026

    @anetrebskii

    Why not to use markdown editors like https://notula.org/ or https://obsidian.md/?

  5. github-actions commented on Oct 8, 2026

    @github-actions
    Contributor

    This issue has been automatically marked as stale because it has had no activity for 60 days. It will be closed in 30 days unless there is a substantive update. If the problem still applies, please provide updated context such as whether it is still reproducible, the affected version or environment, its current impact, and any new reproduction details. A comment that only states that the issue is "still relevant" does not give maintainers enough information to reconsider it.

  6. added
    triage-can-waitVerdict: valid and in-scope but deprioritized; held behind the evidence gate
    on Oct 15, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    triage-can-waitVerdict: valid and in-scope but deprioritized; held behind the evidence gate

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions