Best Folder Hierarchy for Documentation with MKDocs
General
Documentation
Python
If you would like to use python notebooks as the main source of the document and never change the documents in other formats (MD, HTML etc.), then you have to use this hierarchy to avoid from redundant works.
Description :
Simple Expression :
Example :
@startmindmap
title Folder & File Structure for the Best Documentation Publish
right header
Last Check : 14.11.2025
endheader
* main repository
** docs
*** images
*** notebooks (image links : "../images")
**** output folder
****_ output files
***_ MarkDown Documents
** site
** env
** other folders
**_ .gitignore
**_ mkdocs.yml
**_ requirements.txt
@endmindmap
2025 Nov