Skip to main content

Run `clang-format` on C++ code blocks in documentation files

Project description


Run clang-format on C++ code blocks in documentation files. This project is derivative work of blacken-docs. License from blacken-docs is included in LICENSE_blacken_docs


pip install clang-format-docs


clang-format-docs will take markdown files and search for C++ code blocks e.g

    void hello(){
        std::cout << "Hello world\n"

and format them using clang-format, i.e


will rewrite the file with clang-format applied. Also note that you can pass in a different format style using

clang-format-docs --style=LLVM

or using a clang-format config file

clang-format-docs -style=file:my_clang_format.txt

Usage with pre-commit

See pre-commit for instructions

Sample .pre-commit-config.yaml:

-   repo:
    rev: v0.2.1
    -   id: clang-format-docs
        additional_dependencies: [clang-format==14.0.6]

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

clang_format_docs-0.2.2.tar.gz (4.5 kB view hashes)

Uploaded source

Built Distribution

clang_format_docs-0.2.2-py2.py3-none-any.whl (5.7 kB view hashes)

Uploaded py2 py3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page