docs: update api reference

Author: virtualguard101

docs/.nav.yml

@@ -19,6 +19,13 @@ nav:
 
   - API Reference:
     - references/index.md
+    - Frontend or Entry Point:
+      - Command Line Interface: references/cli-api.md
+      - Plugin Core: references/core-api.md
+    - Independent Modules:
+      - Plugin Configuration Module: references/config-api.md
+      - Network Graph Visualization Module: references/graph-api.md
+    - Utils Layers: references/utils-layers.md
 
   - About:
     - Changelog: about/changelog.md

docs/contributing/contributing.md

@@ -13,6 +13,10 @@ First off, thank you for considering contributing to MkDocs Note! It's people li
 
 There are many ways to contribute, from writing documentation and tutorials to reporting bugs and submitting code changes.
 
+For developers, you'd better to read [Architecture Overview](architecture.md) first in order to understand the project framework and design philosophy.
+
+For more details of plugin's api, you can refer to [API References](../references/index.md).
+
 ### Reporting Bugs
 
 If you find a bug, please open an issue and provide the following information:

docs/references/cli-api.md

@@ -0,0 +1,12 @@
+---
+date: 2025-11-05 21:28:00
+title: CLI API
+permalink: 
+publish: true
+---
+
+# CLI API
+
+This section is about the entry point of the [Command Line Interface (CLI)](../usage/cli.md) of the plugin that plays the role to handle CLI front-end calls.
+
+## ::: mkdocs_note.cli

docs/references/config-api.md

@@ -0,0 +1,14 @@
+---
+date: 2025-11-05 21:55:37
+title: Plugin Configuration Module
+permalink: 
+publish: true
+---
+
+# Plugin Configuration Module
+
+This section is about the module that plays the role to handle the plugin configuration which independent from the [plugin core](config-api.md).
+
+It will be called by [plugin core](core-api.md) and [CLI](cli-api.md) directly.
+
+## ::: mkdocs_note.config

docs/references/core-api.md

@@ -0,0 +1,12 @@
+---
+date: 2025-11-05 21:42:47
+title: Plugin Core
+permalink: 
+publish: true
+---
+
+# Plugin Core
+
+This section is about the frontend/entry point of the plugin that plays the role to handle some page related operations.
+
+## ::: mkdocs_note.plugin

docs/references/graph-api.md

@@ -0,0 +1,14 @@
+---
+date: 2025-11-05 22:00:32
+title: Graph Visualization Module
+permalink: 
+publish: true
+---
+
+# Graph Visualization Module
+
+This section was the underlying module of the [network graph visualization](../usage/network-graph.md) feature which migrated from [MkDocs Network Graph Plugin](https://github.com/develmusa/mkdocs-network-graph-plugin).
+
+It will be called by [plugin core](core-api.md) directly.
+
+## ::: mkdocs_note.graph

docs/references/index.md

@@ -1,10 +1,28 @@
 ---
-date: 2025-10-16 14:25:41
+date: 2025-11-05 21:25:00
 title: API References
 permalink: 
-publish: false
+publish: true
 ---
 
 # API References
 
-Start writing your note content...
+This section is generated by [mkdocstrings](https://mkdocstrings.github.io/) and contains the API references for the `mkdocs-note` plugin.
+
+According to the plugin's architecture, the main API of this project are divided into the following sections:
+
+- Frontend or Entry Point
+
+    - <a href="core-api">Plugin Core</a>
+
+    - <a href="cli-api">CLI</a>
+
+- Independent Modules
+
+    - <a href="config-api">Plugin Configuration</a>
+
+    - <a href="graph-api">Graph Visualization</a>
+
+- Utils Layers
+
+    - <a href="utils-layers">Utils Layers</a>

docs/references/utils-layers.md

@@ -0,0 +1,18 @@
+---
+date: 2025-11-05 22:06:28
+title: Utils Layers
+permalink: 
+publish: true
+---
+
+# Utils Layers
+
+This section is about the underlying utility functions that are used in the plugin, will be called by [plugin core](core-api.md) and [CLI](cli-api.md) directly.
+
+And specifically, the `common` module of [CLI](cli-api.md) will call [plugin core](config-api.md) to get the plugin configuration instance, and `scanner` module will call `meta` module to validate the note file's frontmatter.
+
+## ::: mkdocs_note.utils.meta
+
+## ::: mkdocs_note.utils.scanner
+
+## ::: mkdocs_note.utils.cli

docs/usage/asset-manager.md

@@ -7,7 +7,7 @@ publish: true
 
 # Asset Management
 
-The plugin automatically manages assets for each note using a **co-located structure**:
+The plugin automatically manages assets for each note using a **co-located structure** by its [CLI](cli.md):
 
 ## Co-Located Asset Organization
 

mkdocs.yml

@@ -112,13 +112,16 @@ plugins:
       recent_notes_config:
         enabled: true
         insert_marker: "<!-- recent_notes -->"
-        insert_num: 5
+        insert_num: 10
       graph_config:
         enabled: true
         name: "title"
         debug: false
-  # - redirects:
-  #     redirect_maps:
+  - mkdocstrings:
+      handlers:
+        python:
+          options:
+            show_submodules: true
 
 # extra_css: