Diplodoc CLI (yfm-docs)

yfm-docs

Diplodoc platform CLI for building Yandex Flavored Markdown documentation with navigation and multiple languages

  • 123 ★ on the repository
  • Last commit
  • MIT
CLI

Extended access

Why this level

  • Runs the yfm Node tool, which builds documentation and writes output to disk
  • The VCS connector calls GitHub with a token from .env or .yfm
All reasons and checks

diplodoc-platform/cli

Install

In your terminal, with SkillFoxx CLI

npx skillfoxx add cli/yfm-docs

Detects the agents on your machine, shows the access level and pins the version.

Other ways to install

Access and checks

How we review

Extended accessThe tool runs code or makes network calls and only reads external data.

  • Runs the yfm Node tool, which builds documentation and writes output to disk
  • The VCS connector calls GitHub with a token from .env or .yfm

This is third-party code. Review the repository files before installing.

What it does

The @diplodoc/cli package builds a full documentation project with navigation and Yandex Flavored Markdown support. yfm init scaffolds a project with toc.yaml, index.md and settings, including multi-language layouts. yfm content processes a single Markdown file into md or an HTML fragment, and the --raw flag prints clean content without banners, which suits agents and pipelines.

Who it is for. Technical writers and developers maintaining docs-as-code documentation.

Good fit when

  • You start a new YFM documentation portal
  • You need Russian and English docs in one project
  • An agent needs to render one page with includes and variables without building the whole project
  • You want CI to fail on warnings with --strict

Not a fit when

  • Your docs already use another generator and migration is not planned
  • Your environment cannot run Node.js 22 or newer

Example request

Create a Diplodoc documentation project with ru and en languages using the full template, then render index.md to HTML

Limitations

Requires Node.js 22+. yfm content handles a single file and for HTML emits only a fragment without toc or header. The VCS connector needs a GitHub token in .env or .yfm.

How to disable. Remove the global package with npm uninstall -g @diplodoc/cli.

FAQ

How do I get only the content without service output?

Add --raw to yfm content: stdout will contain only the result, without markers or banners.

What is the difference between the minimal and full templates?

full also creates presets.yaml, pc.yaml and an extended .yfm with pdf, search, vcs and authors settings.

Discussion

No questions or reviews yet.

CLI tools
Editors’ pick

A Firecrawl skill and CLI that lets your agent convert Word, PowerPoint, Excel, OpenDocument, RTF, EPUB, CSV and PDF to Markdown on your own machine

SkillExtended access23.2KRepository stars
Official

Four Claude Code plugins from Mintlify: reading others' docs, collaborative drafting, autonomous writing with PRs and style review of documentation

PluginExtended access460Repository stars

An MCP server on top of pandoc: the agent converts Markdown, HTML, DOCX, LaTeX, EPUB, ODT and other formats into one another

MCP serverExtended access584Repository stars

A document pipeline skill: anything to markdown, markdown to clean html and publisher-grade docx, and html back to markdown

SkillExtended access933Repository stars

A skill and CLI that turn Markdown into DOCX, PDF, PPTX, XLSX, PNG and about a dozen more formats, all computed locally

SkillExtended access274Repository stars
Russian stack

MCP server for Yandex Wiki built on the ya-wiki-api package: 36 tools for pages, grids, attachments and a section-tree cache

MCP serverExtended access1Repository stars

README in short

yfm-docs builds documentation projects with navigation and YFM support. The README covers npm installation, yfm init with an interactive wizard and flags, and yfm content for processing a single file. It lists options, generated file layouts and VCS connector setup. The project is MIT-licensed and has a Russian README.

README badge

Report a problem

Foxx AIDiplodoc CLI (yfm-docs)
Foxx AI

I am Foxx AI and I have already vetted this tool. Ask about install, setup or anything else, and I will keep it simple.