https://github.com/diplodoc-platform/cli

Lets make documentation on YFM
https://github.com/diplodoc-platform/cli

Last synced: 3 months ago
JSON representation

Lets make documentation on YFM

• Host: GitHub
• URL: https://github.com/diplodoc-platform/cli
• Owner: diplodoc-platform
• License: mit
• Created: 2020-04-29T13:20:06.000Z (about 6 years ago)
• Default Branch: master
• Last Pushed: 2026-04-02T15:29:50.000Z (3 months ago)
• Last Synced: 2026-04-03T04:58:35.863Z (3 months ago)
• Language: TypeScript
• Homepage:
• Size: 12.9 MB
• Stars: 123
• Watchers: 28
• Forks: 47
• Open Issues: 93
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • Contributing: CONTRIBUTING.md
  • License: LICENSE
  • Codeowners: .github/CODEOWNERS
  • Authors: AUTHORS
  • Agents: AGENTS.md

Awesome Lists containing this project

README

          
**english** | [русский](https://github.com/diplodoc-platform/cli/blob/master/README.ru.md)

---

[![NPM version](https://img.shields.io/npm/v/@diplodoc/cli.svg?style=flat)](https://www.npmjs.org/package/@diplodoc/cli)

[![Quality Gate Status](https://sonarcloud.io/api/project_badges/measure?project=diplodoc-platform_cli&metric=alert_status)](https://sonarcloud.io/summary/new_code?id=diplodoc-platform_cli)

[![Coverage](https://sonarcloud.io/api/project_badges/measure?project=diplodoc-platform_cli&metric=coverage)](https://sonarcloud.io/summary/new_code?id=diplodoc-platform_cli)

[![Maintainability Rating](https://sonarcloud.io/api/project_badges/measure?project=diplodoc-platform_cli&metric=sqale_rating)](https://sonarcloud.io/summary/new_code?id=diplodoc-platform_cli)

[![Reliability Rating](https://sonarcloud.io/api/project_badges/measure?project=diplodoc-platform_cli&metric=reliability_rating)](https://sonarcloud.io/summary/new_code?id=diplodoc-platform_cli)

[![Security Rating](https://sonarcloud.io/api/project_badges/measure?project=diplodoc-platform_cli&metric=security_rating)](https://sonarcloud.io/summary/new_code?id=diplodoc-platform_cli)

# yfm-docs

Yfm-docs lets you build a full-fledged documentation project: with navigation, internal transitions, and full

[Yandex Flavored Markdown (YFM)](https://diplodoc.com/docs/en/index-yfm) support.

![Example of displaying a documentation page](.github/assets/overview.jpg)

## Documentation

[ydocs.tech](https://diplodoc.com/docs/en/tools/docs)

## Requirements

Node 22+

## Usage

```bash

npm i @diplodoc/cli -g

```

```bash

npm run start -- -i ./input-folder -o ./ouput-folder -v "{\"name\":\"Alice\"}"

```

## Source files

### Preparation

You need to add `.env` file into repo root with data below:

```bash

GITHUB_OWNER=

GITHUB_REPO= # docs

GITHUB_TOKEN= # personal access token

GITHUB_BASE_URL= # for ex: https://api.github.com

VCS_CONNECTOR_TYPE= # github

```

or you can update .yfm file into docs repo

```bash

connector:

    type:

    github:

        endpoint:

        token:

        owner:

        repo:

```

### Build from source

```bash

cd cli

npm ci && npm run build

```

## License

MIT