MarkSight MCP server
2026년 11월 14일 커밋AI 클라이언트가 Markdown을 사용하여 Claude Agent Skill 번들을 생성 및 검증하고, Markdown을 HTML로 변환할 수 있게 합니다.
다른 이름 Rinava/MarkSight
- 스타
- 19
- Tools
- —
- 다운로드, 30일
- —
- 최신 버전
- —
- 마지막 커밋
- 2026년 11월 14일
- 라이선스
- MIT
MarkSight MCP란?
MarkSight은(는) MCP server입니다. AI 클라이언트가 Markdown을 사용하여 Claude Agent Skill 번들을 생성 및 검증하고, Markdown을 HTML로 변환할 수 있게 합니다.
프로젝트 README에서 생성된 요약
MarkSight MCP server 정보
MarkSight는 개발자와 AI 애호가들이 Markdown 문서를 설치 가능한 Claude Agent Skill 번들로 변환할 수 있도록 지원합니다. 이 도구는 실시간 미리보기가 가능한 브라우저 기반 Markdown 에디터이자, HTTP transport를 통해 Claude Code에 연결할 수 있는 원격 MCP server 역할을 합니다. 모든 데이터는 로컬 스토리지에 유지되므로 계정이나 서버 측 저장소 없이도 콘텐츠를 작성, 편집 및 내보낼 수 있습니다.
AI 클라이언트에 이 server를 추가하면 create_skill, validate_skill, markdown_to_html, document_outline, document_metrics와 같은 특정 도구를 사용하여 문서 처리 프로세스를 자동화할 수 있습니다. 이 server는 Mermaid 다이어그램 생성, GitHub-flavored markdown 적용, 파일을 .skill 번들로 패키징하는 등의 복잡한 작업을 처리합니다. 단일 인터페이스를 통해 원시 문서를 작성하는 것과 기능적인 AI 역량을 생성하는 것 사이의 간극을 메우도록 설계되었습니다.
활용 사례
- 1Markdown 변환 자동화제공된 도구를 사용하여 AI 클라이언트가 Markdown 텍스트를 HTML 형식으로 변환하도록 지시합니다.
- 2문서 구조 분석AI 인터페이스를 통해 Markdown 문서에 대한 상세한 개요나 특정 지표를 요청합니다.
프로젝트의 README를 바탕으로 작성되었습니다. 모든 활용 사례는 해당 내용의 인용문과 대조하여 확인합니다.
자동 검사
2026년 11월 14일에 실행됨전체 보고서 →아직 인증되지 않았습니다. 서버는 80점 이상의 점수, 심각한 결함 없음, 그리고 검사에 충분한 데이터를 갖추어야 합니다. 검사 방식 · 점수를 높이기 위해 수정할 항목
- 소스 저장소 연결 및 접근 가능rinava/marksight is public and reachablegithub.com/rinava/marksight ↗통과
- 패키지가 이 저장소를 소스로 명시검사되지 않음
- 빌드 출처(Sigstore 증명)검사되지 않음
- 오픈 소스 라이선스 (OSI)MITspdx.org/licenses/MIT.html ↗통과
- 최근 1년 내 커밋 또는 릴리스Last commit or release 2026-11-11github.com/rinava/marksight ↗통과
- OpenSSF Scorecard검사되지 않음
- 패키지 이름이 인기 패키지와 유사하지 않음검사되지 않음
- 패키지 및 해당 종속성에 중요한 보안 권고 없음검사되지 않음
- 모델에 대한 숨겨진 지침 없음0 tool descriptions and the README read; no override phrases, credential paths or hidden characters통과
- 파괴적인 도구에 라벨 표시됨검사되지 않음
- 원격 엔드포인트가 MCP 핸드셰이크에 응답검사되지 않음
README
GitHub에서 보기MarkSight
Turn any Markdown document into an installable Claude Agent Skill. One click, in your browser. MarkSight is a free, open source Markdown editor whose core doubles as a remote MCP server that Claude Code can call directly. Live preview, GFM, Mermaid diagrams, and Markdown/HTML/PDF export come with it.
🔗 Live (no signup): marksight.laramateo.com · 🧩 One-click .skill export · 🔌 Built-in MCP server · 🔒 100% client-side
⭐ If MarkSight is useful to you, starring the repo helps others find it.
Quick start
Use it (nothing to install):
-
Open marksight.laramateo.com, write or paste Markdown, and press ⌘⇧K. An installable
.skillbundle downloads immediately. -
Or add MarkSight's MCP server to Claude Code and let Claude build and validate skills for you:
claude mcp add --transport http marksight https://marksight.laramateo.com/api/mcpThen ask Claude to turn Markdown into a skill or convert it to HTML. Tools:
create_skill,validate_skill,markdown_to_html,document_outline,document_metrics.
Want to run MarkSight locally or contribute? See Getting started.
About
Every README I've ever written started the same way: type some Markdown into GitHub's editor, click Preview, spot something broken, click back to Write, fix it, click Preview again. Write, preview, write, preview. Tiny friction, repeated a thousand times, stops being tiny. So I did the most programmer thing possible: I built my own editor.
MarkSight is the editor I wanted to exist: the preview lives right next to
your words. No tabs, no round trips, everything rendering live as you type.
I built it with React, Next.js, TypeScript, and CodeMirror, and obsessed
over making it feel snappy. It runs entirely in your browser, with no
account and no server-side storage: your document sits in localStorage,
exports are generated on your machine, and your writing never leaves your
device.
I could have kept it as a private little tool that solved a private little annoyance. Instead I made it open source, free for anyone to use, fork, break, and improve. That decision turned out to matter more than any feature I shipped. The longer version of that story is on my blog: Why I built an open source Markdown editor.
Features
- Live preview — CodeMirror editor with an instantly-rendered preview pane
- Smart toolbar — context-aware formatting that detects and toggles existing markdown
- Keyboard shortcuts — bold (⌘B), italic (⌘I), strikethrough (⌘U), link (⌘K), inline code (⌘`), headings (⌘⇧1–3), lists, and more
- Document outline — auto-generated, clickable heading navigation that scrolls the preview
- Export — download the raw Markdown source or styled HTML, print to PDF, or preview the HTML in a new tab; set a custom file name before exporting
- Skill Creator — package your document as an Agent Skill (⌘⇧K) that Claude and other AIs can receive: copy the generated
SKILL.mdor download a ready-to-install.skillbundle. Import existing skills from a.skill/.zipfile or straight from GitHub-hosted marketplaces (like anthropics/skills), modify them, and re-export with bundled files preserved - GitHub-flavored markdown — tables, task lists, strikethrough (via
remark-gfm) - Syntax highlighting — fenced code blocks rendered with Prism
- Mermaid diagrams — fenced
mermaidblocks render as live SVG in the preview and exports, themeable per diagram via%%{init}%%directives or YAML frontmatter - Light / dark theme — system-aware, persisted across sessions
- Local persistence — your document is saved to
localStorageautomatically
Keyboard Shortcuts
Note: On macOS, use ⌘ (Command). On Windows and Linux, use Ctrl.
| Action | macOS | Windows / Linux |
|---|---|---|
| Bold | ⌘ B | Ctrl + B |
| Italic | ⌘ I | Ctrl + I |
| Strikethrough | ⌘ U | Ctrl + U |
| Link | ⌘ K | Ctrl + K |
| Inline Code | ⌘ ` | Ctrl + ` |
| Heading 1 | ⌘⇧1 | Ctrl+Shift+1 |
| Heading 2 | ⌘⇧2 | Ctrl+Shift+2 |
| Heading 3 | ⌘⇧3 | Ctrl+Shift+3 |
| Unordered List | ⌘ ⇧ L | Ctrl + Shift + L |
| Ordered List | ⌘ ⇧ O | Ctrl + Shift + O |
Editor Preview
Light Theme

Dark Theme

A fenced mermaid block renders as a diagram:
graph LR
A[Type Markdown] --> B[Live Preview]
B --> C{Export?}
C -->|HTML| D[Styled HTML]
C -->|PDF| E[Print-ready PDF]
C -->|Markdown| F[.md file]
Tech stack
- Next.js 16 (App Router) + React 19
- Tailwind CSS v4 + shadcn/ui primitives
- CodeMirror (
@uiw/react-codemirror) for editing - react-markdown +
remark-gfmfor rendering - Mermaid for diagram rendering
- next-themes for theming
Getting started
npm install
npm run dev # start the dev server at http://localhost:3000
Other scripts:
npm run build # production build
npm run start # serve the production build
npm run lint # run ESLint
Exporting a document as an Agent Skill
One click: hit the package icon in the preview toolbar (or ⌘⇧K) and a
validated <name>.skill bundle downloads immediately. The metadata comes
from your document (the first H1 becomes the name, the first paragraph the
description) and the toast shows the add-to-Claude steps.
Everything optional lives in the Agent Skill sidebar card: edit the name
and trigger description inline (validated as you type), switch between
Instructions/Knowledge packaging, refine with AI, or import an existing skill
from a .skill file or a GitHub marketplace to edit and re-export.
Everything runs locally in your browser.
To add the skill to Claude Code:
unzip -o ~/Downloads/<name>.skill -d ~/.claude/skills/
It loads on the next session (or after /reload-plugins). On claude.ai,
upload the .skill file under Settings › Capabilities › Skills.
Optionally, an Improve with AI button refines the skill's name and trigger
description (via Vercel AI Gateway). It appears only when the backend has
gateway credentials (see .env.example); without them the
whole Skill Creator keeps working offline.
You can also import an existing skill from the same dialog: open a
.skill/.zip bundle or SKILL.md file, or paste a GitHub URL (a repo, a
folder, or a SKILL.md link, e.g. the official
anthropics/skills collection). The
skill's frontmatter is preserved (frontmatter always overrides auto-derived
metadata), bundled files like references/ are carried through untouched, and
you can edit the body and re-export.
MCP server (use MarkSight from Claude)
MarkSight exposes its core as a remote MCP
server at /api/mcp (streamable HTTP), so Claude and other MCP clients can
call it directly:
claude mcp add --transport http marksight https://marksight.laramateo.com/api/mcp
Tools: create_skill (markdown in, validated .skill bundle out as base64),
validate_skill, markdown_to_html, document_outline, and
document_metrics, all backed by the same src/lib code the editor uses. A project-scoped
.mcp.json is included, so cloning this repo wires the
connector automatically in Claude Code.
Regenerating brand assets
App icons and social images are generated from inline SVG with sharp:
node scripts/generate-assets.mjs
This writes the manifest icons (public/icon*.png) and the Next.js
metadata images (src/app/apple-icon.png, opengraph-image.png, twitter-image.png).
Project structure
src/
├── app/ # App Router entry (layout, page, metadata, route assets)
│ └── api/ # route handlers (MCP server, AI skill improvement)
├── components/ # UI components (editor, preview, toolbar, sidebar, …)
│ └── ui/ # shadcn/ui primitives
├── contexts/ # React context providers
├── hooks/ # custom hooks
├── lib/ # utilities (slugify, local storage, syntax highlighter, …)
└── proxy.ts # security headers / CSP
Contributing
Contributions are welcome, whether it's a bug report, a feature idea, a docs fix, or a pull request. See the contributing guide for how to set up the project and submit changes, and please follow our Code of Conduct.
New here? Look for issues labelled
good first issue.
Release history lives in the changelog.
Community
Questions, ideas, or just want to show what you built with MarkSight? Join the conversation in GitHub Discussions. For bugs and feature requests, open an issue.
Contributors
Here's the thing nobody tells you about open sourcing a project: at some point, the code stops being the point. The first time a stranger opened a pull request here, I just sat there smiling at my screen. Every avatar below is someone who read the code, understood it, and spent their free time making it better:
(Dependabot also sends its regards.)
Contributors are credited in the app too, on the
About page and the workspace footer.
Want in? The contributing guide has everything you need,
and
good first issue
is the easiest way to start. PRs here get reviewed quickly instead of
collecting dust.
Author
MarkSight was created and is maintained by Lara Mateo (@Rinava).
MarkSight is built by the team behind Kenda.
License
MIT.
MarkSight MCP 질문
Claude Code에 MarkSight MCP server를 어떻게 추가하나요?
HTTP transport와 /api/mcp 엔드포인트 URL을 사용하여 claude mcp add 명령어를 실행하십시오. 프로젝트 범위의 .mcp.json 파일도 레포지토리에 포함되어 있습니다.
MarkSight MCP server는 어떤 도구를 제공하나요?
에디터에서 사용하는 것과 동일한 라이브러리 코드를 기반으로 create_skill, validate_skill, markdown_to_html, document_outline, document_metrics 도구를 제공합니다.
MarkSight가 문서를 서버에 저장하거나 전송하나요?
아니요, 에디터는 브라우저에서 완전히 실행되며 localStorage에 저장하고 내보내기 작업도 로컬에서 생성합니다.
MarkSight가 지원하는 내보내기 형식은 무엇인가요?
가공되지 않은 Markdown 또는 스타일이 적용된 HTML을 다운로드할 수 있으며, PDF로 인쇄하거나 새 탭에서 HTML을 미리 볼 수 있습니다.
Skill Creator를 사용하려면 계정이나 API key가 필요한가요?
Skill Creator는 완전히 오프라인으로 작동합니다. 선택 사항인 Improve with AI 버튼은 백엔드에 게이트웨이 자격 증명이 있는 경우에만 나타납니다.