Yandex Wiki

Вы можете экспортировать статьи из Yandex Wiki в Markdown, а затем опубликовать каталоги в свое Git-хранилище и использовать в Gramax.

Gramax сохраняет иерархию, изображения, диаграммы и большую часть оформления.

Что потребуется

Node.js версии 18 или выше (необходим для работы CLI).
Текстовый редактор, например Visual Studio Code.
Терминал.

Шаг 1. Установка Gramax CLI

Gramax CLI можно использовать двумя способами: без установки через npx или с глобальной установкой.

Без установки: Для использования выполните: npx gramax-cli <command> [options].
Глобальная установка: Для регулярного использования выполните: npm install -g gramax-cli.

После этого команды CLI доступны из любой папки.

Шаг 2. Получение данных из Яндекс Вики

Откройте Yandex Wiki и войдите в систему.
Нажмите F12, чтобы открыть консоль разработчика.
Перейдите на вкладку Network → Fetch/XHR.
В левой панели выберите любую статью. В консоли появится запрос getPageDetails.
Щелкните правой кнопкой мыши на запросе → Копировать → Копировать как fetch (Node.js).
Сохраните скопированный код в текстовом файле.

Шаг 3. Настройка Gramax CLI

Создайте файл gramax.config.yaml в рабочей директории.
Вставьте в него шаблон конфигурации.
```
import:
   yandex:
      headers:
            "x-csrf-token": "your-csrf-token"
            "x-org-id": "your-org-id"
            cookie: "your-cookie-string"
            "x-collab-org-id": "optional-collab-org-id"
```

Заполните шаблон данными, которые скопировали из Yandex Wiki в шаге 2. Пример заполненного шаблона:

import:
   yandex:
      headers:
            "x-csrf-token": "e8399826638e73245k0f1cfe5a944b87683bbs10:1754349881"
            "x-org-id": "1331068"
            cookie: "yandexuid=8626904001695300517; yuidss=8626904001695300517; gdpr=0; _ym_uid=1695303700525969138; yandex_login=name@name.ru;...924b99683bbb10%33878179541"
            "x-collab-org-id": "cf3c7652-ae27-455f-a126-9de4f12cegaa"

Сохраните файл.

Внимание

Параметр x-collab-org-id не обязателен. Если у вас этого значения нет, просто не указывайте данный параметр.

Шаг 4: Запуск

Откройте консоль и выполните команду:

npx gramax-cli import yandex-wiki --destination <path> --config <path> [--raw]

Где:

--destination, -d — путь до папки, в которую экспортируются статьи из Yandex Wiki.
--config, -c — путь до папки, в которой лежит файл gramax.config.yaml.
--raw, -r — параметр, который выключает трансформацию Markdown под формат Gramax. Если указан — статьи экспортируются в разметке Yandex Wiki. Если не указан — в разметке Gramax.

Результат

В указанной директории создастся папка yandex-wiki-catalog.
Каждая статья сохранится как MD-файл.
Изображения и диаграммы экспортируются как отдельные файлы рядом с соответствующими статьями.

Notion

Мультиязычность