# Markdown

Ingest Markdown and plain text files

- Repository: https://github.com/axoviq-ai/synthadoc (1725 stars)
- Category: Engineering
- License: AGPL-3.0-or-later
- Last updated: 2026-11-01
- Runs scripts: yes, review before use

## Install

Claude Code: `npx skills add axoviq-ai/synthadoc --skill markdown -g -a claude-code -y`
Codex: `npx skills add axoviq-ai/synthadoc --skill markdown -g -a codex -y`
Cursor: `npx skills add axoviq-ai/synthadoc --skill markdown -g -a cursor -y`
Gemini CLI: `npx skills add axoviq-ai/synthadoc --skill markdown -g -a gemini-cli -y`

## Description

Ingest Markdown and plain text files

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# Markdown Skill

Reads a Markdown or plain text file and returns its content verbatim.

## Setup

No external dependencies, uses only the Python standard library.

## Standalone usage

```python
import asyncio
from synthadoc.skills.markdown.scripts.main import MarkdownSkill

skill = MarkdownSkill()

async def main():
    result = await skill.extract("/path/to/notes.md")
    print(result.text)      # file contents verbatim

asyncio.run(main())
```

## When this skill is used

- Source path ends with `.md` or `.txt`
- User intent contains: `markdown`, `text file`, `notes`