{"id":22492490,"url":"https://github.com/six-two/mkdocs-knowledge-base-guide","last_synced_at":"2025-03-27T20:30:12.701Z","repository":{"id":261854827,"uuid":"860963675","full_name":"six-two/mkdocs-knowledge-base-guide","owner":"six-two","description":"Publish your Markdown notes (Obsidian, Trillium, etc) as a website with MkDocs","archived":false,"fork":false,"pushed_at":"2024-12-01T19:05:03.000Z","size":345,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-02-01T22:48:25.810Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"https://mkdocs-knowledge-base-guide.six-two.dev/","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/six-two.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-09-21T16:25:47.000Z","updated_at":"2024-12-01T19:05:07.000Z","dependencies_parsed_at":"2024-11-08T20:35:28.695Z","dependency_job_id":"25052a11-3b1d-4061-aeac-c662f74ebe76","html_url":"https://github.com/six-two/mkdocs-knowledge-base-guide","commit_stats":null,"previous_names":["six-two/mkdocs-knowledge-base-guide"],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/six-two%2Fmkdocs-knowledge-base-guide","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/six-two%2Fmkdocs-knowledge-base-guide/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/six-two%2Fmkdocs-knowledge-base-guide/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/six-two%2Fmkdocs-knowledge-base-guide/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/six-two","download_url":"https://codeload.github.com/six-two/mkdocs-knowledge-base-guide/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":245919482,"owners_count":20693896,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-12-06T18:18:22.646Z","updated_at":"2025-03-27T20:30:12.674Z","avatar_url":"https://github.com/six-two.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# MkDocs Knowledge Base Guide\n\nThis guide aims to show you how to publish your knowledge base with MkDocs.\nIt mainly describes my setup, so it focuses on extensions I personally use or created for my knowledge base.\n\nYou can read the guide at \u003chttps://mkdocs-knowledge-base-guide.six-two.dev/\u003e or you can clone this repository and serve it with mkdocs.\n\n## MkDocs advantages\n\n- Actively developed\n- Creates a static site that can be hosted anywhere cheaply (or even for free)\n- Has a fully client side search function\n- Has really great Material theme and many other plugins\n- Writing small custom extensions is relatively easy, since it can be done in Python.\n    The [hooks](https://www.mkdocs.org/user-guide/configuration/#hooks) option also enables writing custom hooks without creating all the boilerplate code that a \"proper\" extension needs.\n\n## MkDocs Drawbacks\n\nMkDocs processes all sites sequentially.\nThis can lead to slow build performance, which makes the live reloading for large sites nearly unusable in my opinion.\nFor my personal knowledge base, which contains over 700 pages with over 39k lines in total and uses many plugins, the build process takes around 40 seconds on a M3 Macbook.\nIn the CI/CD pipeline, the build takes much longer.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsix-two%2Fmkdocs-knowledge-base-guide","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsix-two%2Fmkdocs-knowledge-base-guide","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsix-two%2Fmkdocs-knowledge-base-guide/lists"}