Ignore a file

mkdocs.yml

# This tests if the site directory is ignored in both build and serve.
site_name: ok-mkdocs-ignore-file
plugins:
- simple:

Input

ok-mkdocs-ignore-file/
├── hello_world.cpp
├── mkdocs.yml
├── README.md
└── test.md

hello_world.cpp

/** md-ignore

# Ignore me

Ignore everything beyond the first line since it contains md-ignore.
**/

#include <iostream>

int main() {
  /** md
  # Hello world

  This is the main function for hello world.
  It outputs "Hello World!" to the screen.
  **/
    std::cout << "Hello World!";
    return 0;
}

Output

site/
├── assets/
│   ├── images/
│   │   └── favicon.png
│   ├── javascripts/
│   │   ├── lunr/
│   │   │   └── min/
│   │   └── workers/
│   └── stylesheets/
├── index.html
└── test/
    └── index.html