Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion .github/agents/laravel-package.agent.md
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
---
name: laravel-package
description: "Researches Laravel packages and generates Obsidian notes. Usage: /laravel-package <vendor/package>"
tools: ["read", "search", "edit"]
tools: ["read", "search", "edit", "browser"]
mcp-servers:
deepwiki:
type: sse
Expand Down
8 changes: 7 additions & 1 deletion .github/agents/mcp-research.agent.md
Original file line number Diff line number Diff line change
@@ -1,14 +1,20 @@
---
name: mcp-research
description: "Researches a Model Context Protocol (MCP) server from a URL and generates a structured research note. Usage: /mcp-research <url>"
tools: ["read", "search", "edit"]
tools: ["read", "search", "edit", "browser"]
mcp-servers:
deepwiki:
type: sse
url: https://api.deepwiki.com/sse
tools: ["*"]
headers:
Authorization: "Bearer $DEEPWIKI_KEY"
context7:
command: npx
args: ["@context7/mcp-server"]
tools: ["*"]
env:
CONTEXT7_API_KEY: $CONTEXT7_KEY
github:
type: sse
url: https://mcp.github.com/sse
Expand Down
8 changes: 7 additions & 1 deletion .github/agents/skill-research.agent.md
Original file line number Diff line number Diff line change
@@ -1,14 +1,20 @@
---
name: skill-research
description: "Researches a GitHub Copilot skill from a GitHub URL and generates a structured research note. Usage: /skill-research <github-url-to-skill-directory>"
tools: ["read", "search", "edit"]
tools: ["read", "search", "edit", "browser"]
mcp-servers:
deepwiki:
type: sse
url: https://api.deepwiki.com/sse
tools: ["*"]
headers:
Authorization: "Bearer $DEEPWIKI_KEY"
context7:
command: npx
args: ["@context7/mcp-server"]
tools: ["*"]
env:
CONTEXT7_API_KEY: $CONTEXT7_KEY
github:
type: sse
url: https://mcp.github.com/sse
Expand Down
73 changes: 73 additions & 0 deletions .steering/laravel-packages/spatie__laravel-markdown-response.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,73 @@
---
title: laravel-markdown-response
org: spatie
package: laravel-markdown-response
github_url: https://github.com/spatie/laravel-markdown-response
docs_url: https://spatie.be/docs/laravel-markdown-response/v1/introduction
composer_require: composer require spatie/laravel-markdown-response
author: Freek Van der Herten
announce_date: 2025-04-07
latest_release: v1.1.0 (2026-02-22)
release_date: 2026-02-22
laravel_news_url: https://laravel-news.com/serve-markdown-versions-of-your-laravel-pages-to-ai-agents
downloads_30d:
Comment thread
ChrisThompsonTLDR marked this conversation as resolved.
stars: 67
tags: [laravel, packages, markdown, ai, ai-agents, llm, response, content-negotiation, llms-txt]
---
Comment thread
ChrisThompsonTLDR marked this conversation as resolved.

# laravel-markdown-response

**A Laravel package that lets you serve Markdown versions of your web pages alongside standard HTML responses, enabling AI agents and LLM-powered tools to consume your content directly.**

## Key Features
- Register routes that automatically have a `.md` Markdown counterpart
- Return `MarkdownResponse` instead of a standard view response to serve structured Markdown
- Supports content negotiation via `Accept` header and `.md` URL suffix
- Enables AI crawlers and agents to read your pages as clean Markdown
- Integrates seamlessly with existing Laravel route definitions
- Pair with `llms.txt` conventions for full AI-agent discoverability

## Installation

```bash
composer require spatie/laravel-markdown-response
```

## Usage

Return a `MarkdownResponse` from any controller action:

```php
use Spatie\LaravelMarkdownResponse\MarkdownResponse;

class DocsController extends Controller
{
public function show(string $slug): MarkdownResponse
{
$content = // fetch your Markdown content...

return new MarkdownResponse($content);
}
}
```

Or register a route with an automatic Markdown counterpart:

```php
use Spatie\LaravelMarkdownResponse\MarkdownResponse;

Route::get('/docs/{slug}', function (string $slug) {
return new MarkdownResponse(
view: 'docs.show',
data: ['slug' => $slug],
);
})->withMarkdownRoute();
```

Visiting `/docs/introduction.md` (or sending `Accept: text/markdown`) will return the Markdown version; `/docs/introduction` returns the normal HTML view.

## Resources
- [GitHub](https://github.com/spatie/laravel-markdown-response)
- [Docs](https://spatie.be/docs/laravel-markdown-response/v1/introduction)
- [Laravel News](https://laravel-news.com/serve-markdown-versions-of-your-laravel-pages-to-ai-agents)
- [[Laravel Packages]]
Comment thread
ChrisThompsonTLDR marked this conversation as resolved.