Przejdź do treści
Biblioteka skilli
Dokumenty i biuro · Konwersja i formaty

v1-md2docs

/v1-md2docs

Zamienia plik Markdown w sformatowany dokument Google Docs, gotowy do publikacji i udostępnienia.

Repozytorium
v1tamins ↗
Licencja
MIT
Ostatnia zmiana repozytorium
24.10.2026

Ocena i bezpieczeństwo

100/ 100Klasa: dobry
Format25 / 25
Frontmatter z nazwą i opisem, poprawna nazwa, opis do 1024 znaków, nazwa zgodna z folderem.
Odkrywalność25 / 25
Opis mówi, kiedy użyć skilla, ma sensowną długość i jest w 3. osobie.
Treść35 / 35
Co najmniej 150 słów i do 500 linii, nagłówki, listy kroków, przykłady albo kod.
Higiena15 / 15
Bez zaślepek typu TODO, bez ścieżek Windows, z licencją.
Ryzykobrak sygnałów w skanie
Pliki w paczce
3
Skrypty
1
Komentarze HTML
0
Adresy URL w SKILL.md
2
Przestarzałość

Brak sygnałów. Repozytorium zmienione 24.10.2026, bez odwołań do wycofanych modeli i API.

Licencja

MIT, otwarta: można używać i zmieniać, z zachowaniem informacji o autorze.

Co sprawdzić przed instalacją
  • 1 skrypt w paczce. Przejrzyj je przed instalacją, bo Claude może je uruchomić.

Skrypty: scripts/md2docs.py

Co robi i kiedy

Zamienia plik Markdown w sformatowany dokument Google Docs, gotowy do publikacji i udostępnienia.

Wyzwalacze z opisu

Markdown to Google Docpublish this markdown as a doc
Oryginalny opis (EN)

Use when explicitly converting a Markdown file into a formatted Google Doc. Triggers on "Markdown to Google Doc" or "publish this markdown as a doc".

Jak działa

  1. Usage
  2. Workflow
  3. First-Time Setup
  4. What Gets Formatted
  5. Environment Variables
  6. Dependencies
Sekcje z nagłówków SKILL.md, w oryginale · 117 linii, 668 słów
Podgląd SKILL.md
---
name: v1-md2docs
description: Use when explicitly converting a Markdown file into a formatted Google Doc. Triggers on "Markdown to Google Doc" or "publish this markdown as a doc".
disable-model-invocation: true
allowed-tools:
  - Bash
---
# md2docs

Convert a Markdown file to a formatted Google Doc with one command.

## Usage

Typical invocations:
- Claude Code: `/v1-md2docs path/to/file.md`
- Codex: invoke `v1-md2docs` from the skills menu or use `$v1-md2docs path/to/file.md`

Optional arguments after the file path:
- `--title "Custom Title"` to override the doc title (default: filename as title case)
- `--no-open` to skip opening the browser

## Workflow

1. Resolve the markdown file path from the user input.
   For a bare invocation, infer it only when exactly one Markdown file is clearly
   in scope in the conversation. Otherwise ask which file to convert; do not
   select the newest file or scan for an arbitrary candidate.
2. Confirm the selected file exists and is readable before environment setup.
   Reuse a suitable project-local Python virtual environment when available,
   or create the default below. Run dependency checks, installation, and
   conversion with that same interpreter from the skill root:

Run this shell block with Bash. If your tool defaults to zsh or another shell,
select Bash first; cache glob handling depends on it.

```bash
REPO_ROOT="$(git rev-parse --show-toplevel 2>/dev/null || pwd)"
RESOLVER=""
for candidate in \
  "$REPO_ROOT/plugins/v1tamins/scripts/resolve-skill-root.sh" \
  "${CLAUDE_PLUGIN_ROOT:-}/scripts/resolve-skill-root.sh" \
  "$HOME/.claude/skills/v1-md2docs/../../scripts/resolve-skill-root.sh" \
  "$HOME/.codex/skills/v1-md2docs/../../scripts/resolve-skill-root.sh" \
  "$HOME/.claude/plugins/cache"/*/v1tamins/*/scripts/resolve-skill-root.sh \
  "$HOME/.codex/plugins/cache/v1tamins/v1tamins"/*/scripts/resolve-skill-root.sh; do
  [ -x "$candidate" ] && RESOLVER="$candidate" && break
done
if [ -z "${RESOLVER:-}" ]; then
  echo "ERROR: Could not find resolve-skill-root.sh" >&2
  exit 1
fi
SKILL_ROOT="$("$RESOLVER" v1-md2docs scripts/md2docs.py)"

VENV_DIR="$REPO_ROOT/.venv/md2docs"
# Set VENV_DIR to the existing project-local environment when reusing one.
if [ ! -x "$VENV_DIR/bin/python" ]; then
  python3 -m venv "$VENV_DIR" || exit 1
fi
PYTHON="$VENV_DIR/bin/python"
"$PYTHON" "$SKILL_ROOT/scripts/md2docs.py" <file_path> [--title "Title"] [--no-open]
```

   If dependencies are missing, install the reported packages into that same
   environment with `"$PYTHON" -m pip install markdown google-auth
   google-auth-oauthlib google-api-python-client`, then rerun the conversion.
   Record its absolute Python path and restore `PYTHON` to that exact path
   before installation or conversion in a fresh shell; rerun the resolver
   block as well to restore `SKILL_ROOT`.
   Do not install into the system interpreter or bypass an externally managed
   environment. If environment creation or installation fails, report it before
   attempting authentication or document creation.
3. Report the returned Google Doc URL after successful conversion. Do not
   repeat a document-creation request after an uncertain upload; reconcile the
   destination before another attempt.

## First-Time Setup

If the script reports `No client_secret.json found`, guide the user through setup:

1. Go to [Google Cloud Console](https://console.cloud.google.com/)
2. Create a project or use an existing one
3. Enable the **Google Drive API**
4. Go to **APIs & Services > Credentials**
5. Create an **OAuth 2.0 Client ID** with application type **Desktop app**
6. Download the JSON file
7. Save it to `~/.md2docs/client_secret.json`

The first run opens a browser for OAuth consent. After that, the token is cached at `~/.md2docs/token.json` and no browser auth is needed until the token expires.

Each developer authenticates with their own Google account. Docs are created in their personal Google Drive.

## What Gets Formatted

- H1-H6 headings with native Google Docs heading styles
- **Bold**, *italic*, and ***bold+italic***
- `inline code` with Courier New font and gray background
- Fenced code blocks with Courier New font, gray background, and border
- Tables with bordered cells and header row styling
- Unordered and ordered lists with proper nesting
- [Links](https://example.com) as clickable hyperlinks
- Horizontal rules
- Mermaid diagrams rendered as embedded images when an installed `mmdc` succeeds;
  otherwise the diagram source remains a visible code block

## Environment Variables

- `MD2DOCS_CLIENT_SECRET` overrides the default `client_secret.json` path

## Dependencies

Install these packages in the isolated environment. The script reports missing
dependencies and exits before authentication; it never installs packages:
- `markdown`
- `google-auth`
- `google-auth-oauthlib`
- `google-api-python-client`

Mermaid image rendering is separate from the Python prerequisites. It uses
only an already installed `mmdc` executable from `@mermaid-js/mermaid-cli` on
`PATH`. The converter never invokes `npx` or fetches a Node package. If `mmdc`
is absent or rendering fails, it preserves the diagram as a visible code block.
Installing an optional renderer is a separate setup choice; it is not required
to create the document.
Pliki w paczce (3)
  • SKILL.md 5 KB
  • agents/openai.yaml 1 KB
  • scripts/md2docs.py 15 KB

Wersje

W bazie nie ma innych skilli o nazwie v1-md2docs.

Migawka bazy z 13.11.2026 · wersja paczki 3cd546f7e65a (skrót SHA-256 całej paczki)

Pobrania w ostatnich 30 dniach: 0 · ranking

Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.

Podobne skille

  • 95doc-to-markdown
    Zamienia dokumenty Word .doc i .docx na czysty Markdown przy użyciu MinerU, do czytania lub edycji.
  • 100notebook-to-google-doc
    Zamienia gotowy notebook z analizą w dokument Google Docs w standardowym układzie Podsumowanie, Tło i Wyniki, do udostępnienia szerszemu gronu.
  • 100google-chat-formatting
    Konwertuje Markdown do składni Google Chat przy formatowaniu wiadomości i dokumentów.
  • 93gdocs
    Czyta, tworzy i edytuje dokumenty Google Docs: podsumowuje treść, wstawia tabele i obrazy, komentuje i eksportuje.
  • 100glyphdown
    Współpracuje nad dokumentami i plikami Glyphdown (Dokumenty Google dla markdown) przez CLI: synchronizacja notatek, wysyłanie plików, sugestie, komentarze i udostępnianie linkiem.
  • 100docs
    Tworzy dokument HTML w kolorach i czcionkach organizacji, z logo i autorem, albo zamienia plik Markdown w taki dokument.

Uwagi i zgłoszenia

Wiadomość trafi do Bartosza Sokolińskiego. Adres e-mail jest potrzebny tylko do odpowiedzi. Szczegóły w polityce prywatności.