md-anything: Instructions file for GitHub Copilot

.github/copilot-instructions.md

md-anything copilot-instructions.md is an instructions file for GitHub Copilot from ojspace/md-anything. It costs 903 tokens per session, scanned A, original, MIT.

Contributor instructions for md-anything, a tool that converts inputs such as text, videos, and documents into Markdown. They cover Bun commands for installing, building, linting, testing, and generating PDF or EPUB fixtures.

In plain words
What is it for?
They help run builds and tests, test individual cases, regenerate document fixtures, and diagnose optional local tool support.
Why use it?
They provide the commands and project structure needed to check changes and debug the conversion tool.

Instructions file for GitHub Copilot

Written for GitHub Copilot: a Copilot instructions file.

This is ojspace/md-anything's own configuration. It tells GitHub Copilot how to work on md-anything itself, so it is not a mod to install elsewhere. Copy it as a starting point and replace the rules that are about this project. Everything md-anything configures →

Reuse

Borrowing it

Nothing to install: this file belongs to ojspace/md-anything. Take a copy, put it at the same path in your own repository, and replace the rules that are about this project with yours.

Copy the file
curl -O https://raw.githubusercontent.com/ojspace/md-anything/main/.github/copilot-instructions.md
Clone the repo
git clone --depth 1 https://github.com/ojspace/md-anything

Made for: GitHub Copilot.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for md-anything copilot-instructions.md

README.md
[![agentmods](https://agentmods.dev/badge/instructions/ojspace/md-anything/copilot-instructions/github.svg)](https://agentmods.dev/instructions/ojspace/md-anything/copilot-instructions)
Your own site
<a href="https://agentmods.dev/instructions/ojspace/md-anything/copilot-instructions"><img src="https://agentmods.dev/badge/instructions/ojspace/md-anything/copilot-instructions/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for md-anything copilot-instructions.md

Your own site · 80×15
<a href="https://agentmods.dev/instructions/ojspace/md-anything/copilot-instructions"><img src="https://agentmods.dev/badge/instructions/ojspace/md-anything/copilot-instructions.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 903 This file is loaded in full into every session.
When invoked 903 The same file — it is already loaded in full.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00903 $0.00903
Opus 5.5 $0.00361 $0.00361
Sonnet 5.5 $0.00181 $0.00181
Haiku 4.5 $0.00090 $0.00090

Measured 1mo ago against content hash 77b3b751d45f, method: parsed. Prices are Anthropic first-party input rates as of 2026-10-07, from the pricing page.

Security

Grade A, and why

md-anything copilot-instructions.md scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 1mo ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

.github/copilot-instructions.md · 82 lines

How it starts

The opening of the file, as written. The whole thing — 82 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Copilot instructions for md-anything

Build, test, and lint commands

Use Bun throughout this repository.

bun install
bun run lint
bun run build

# Full suite
bun test
bun run test

# Contributor-safe required subset
bun run test:required

# Regenerate generated PDF/EPUB fixtures when needed
bun run test:fixtures

# Run a single test file
bun test tests/unit/detect-input.test.ts

# Run one test by name
bun test tests/integration/convert-text.test.ts -t "converts .txt file to markdown"

# Live/network tests
LIVE_TESTS=1 bun test tests/integration/youtube-live.test.ts tests/integration/url-live.test.ts

When debugging optional local tool support, run bun run src/cli.ts doctor.

High-level architecture

  • src/cli.ts and src/mcp.ts are the shipped entry points. They both build a runtime with createRuntimeProviders(DEFAULT_CONFIG) and delegate to shared core logic instead of implementing format-specific behavior themselves.

  • The main conversion path lives in src/core/convert.ts: validate with ConvertRequestSchema, detect the input kind, route with routeInput, normalize quality metadata with finalizeDocument, attach chunk/provenance data, and render Markdown with formatMarkdown.

  • src/providers/* contains one converter per input kind. Providers return a NormalizedDocument; they should not format final Markdown themselves.

  • Runtime capability checks are centralized in src/core/runtime.ts. Optional tools such as tesseract, pdftotext, ebook-convert, unzip, ffmpeg, whisper-cpp, and whisper are detected once and then passed through the runtime so providers can gate behavior consistently.

  • src/core/ingest.ts walks supported files in a folder, converts them through the shared pipeline, and returns counts plus per-document metadata. It does not currently process source manifests or generate graph/index artifacts.

  • src/mcp-support.ts is the MCP policy layer: it restricts local paths to the current workspace root, blocks private URLs by default, and defines structured tool output, resources, and prompts.

Read the full file on GitHub · 82 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 1mo ago First seen · 82 lines · 903 tokens per session scan A 77b3b751d45f

Subscribe to this mod's changes

md-anything copilot-instructions.md is an instructions file published in the GitHub repository ojspace/md-anything (49 stars, last pushed 1mo ago), licensed MIT. It adds 903 tokens to every session, about $0.0036 per session on Opus 5.5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.

Related

Other instructions, from other repositories

vscode buildNext.instructions.md

Working notes and architecture documentation for the new esbuild-based build system in build/next. Use when making changes to the new build pipeline (transpile/bundle commands, NLS plugin, source-map handling, resource copying, or self-hosting watch tasks).

microsoft/vscode · 9,649 tokens

next.js AGENTS.md

AGENTS.md instructions for vercel/next.js, covering next.js development guide, codebase structure, monorepo overview, core package: packages/next and other important packages.

vercel/next.js · 7,257 tokens

vscode oss-third-party-notices.instructions.md

Instructions for microsoft/vscode, covering vs code oss third-party-notices pipeline, architecture, pipeline flow in ci, cache eligibility and rollout and applying the notice (cutover).

microsoft/vscode · 5,262 tokens

langchain AGENTS.md

AGENTS.md instructions for langchain-ai/langchain, covering global development guidelines for the langchain monorepo, corridor security analysis, project architecture and context, monorepo structure and development tools & commands.

langchain-ai/langchain · 4,680 tokens

vscode copilot-instructions.md

Copilot instructions for microsoft/vscode, covering vs code copilot instructions, project overview, root folders, core architecture (src/ folder) and built-in extensions (extensions/ folder).

microsoft/vscode · 2,731 tokens

deepseek-harness AGENTS.md

AGENTS.md instructions for deepseek-ai/deepseek-harness, covering agents.md, pre-stable apis and released session data, repository layout, commands and host sandbox failures.

deepseek-ai/deepseek-harness · 4,159 tokens