# azaken1248/markdownviewer architecture

> Architecture diagram of the GitHub repository azaken1248/markdownviewer, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-05). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/azaken1248/markdownviewer
- Repository: https://github.com/azaken1248/markdownviewer

## Overview

AzaDocs is a self-hosted Markdown library whose files remain ordinary files on disk, with SQLite holding application metadata. The main workflow is browsing or searching documents, opening a real document address, and editing it in place; adjacent capabilities include folder organization, uploads, accounts, sharing, saved links, and rich rendering/export. The README documents these product features, while the server excerpt and SOURCE INDEX expose selected wiring. Several client and route implementations were not sampled, so their internal call relationships are not asserted.

Main entry points: [`public/js/app.js`](https://github.com/azaken1248/markdownviewer/blob/main/public/js/app.js) (Library reader), [`lib/routes/docs.js`](https://github.com/azaken1248/markdownviewer/blob/main/lib/routes/docs.js) (Document routes), [`server.js`](https://github.com/azaken1248/markdownviewer/blob/main/server.js) (Express application), [`lib/db.js`](https://github.com/azaken1248/markdownviewer/blob/main/lib/db.js) (Application metadata)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Browser library"]
  node_reader["Library reader<br/>[app.js]"]
  node_search["Full-text search<br/>[search.js]"]
  node_editing["In-place editing<br/>[page-edit.js]"]
end

subgraph group_documents["Document management"]
  node_docs["Document routes<br/>[docs.js]"]
  node_folders["Folder routes<br/>[folders.js]"]
  node_uploads["Document uploads<br/>[upload.js]"]
  node_files[("Markdown files")]
end

subgraph group_identity["Identity and sharing"]
  node_authroutes["Account routes<br/>[auth.js]"]
  node_auth["Authentication and roles<br/>[auth.js]"]
  node_metadata[("Application metadata<br/>[db.js]")]
  node_shares["Share routes<br/>[shares.js]"]
  node_savedlinks["Saved links<br/>[links.js]"]
  node_preview["Link previews<br/>[link-preview.js]"]
end

subgraph group_rich["Rich content"]
  node_markdown["Markdown rendering<br/>[markdown-core.js]"]
  node_diagrams["Flowchart builder<br/>[diagram-editor.js]"]
  node_notebooks["Notebook execution"]
  node_export["Document export<br/>[export.js]"]
end

subgraph group_runtime["Server runtime"]
  node_server["Express application<br/>[server.js]"]
end

node_visitor(("Library user"))

node_visitor -->|"browses"| node_reader
node_reader -.->|"opens documents"| node_docs
node_reader -->|"searches library"| node_search
node_search -.->|"requests search"| node_docs
node_reader -->|"edits in place"| node_editing
node_editing -.->|"writes changes"| node_docs
node_docs -->|"reads and writes"| node_files
node_folders -->|"moves directories"| node_files
node_uploads -.->|"stores documents"| node_files
node_authroutes -->|"calls authentication"| node_auth
node_auth -->|"queries accounts"| node_metadata
node_shares -.->|"stores share metadata"| node_metadata
node_savedlinks -->|"stores link metadata"| node_metadata
node_savedlinks -->|"fetches previews"| node_preview
node_reader -->|"renders content"| node_markdown
node_reader -->|"edits diagrams"| node_diagrams
node_reader -->|"runs notebook code"| node_notebooks
node_reader -.->|"exports documents"| node_export
node_server -->|"mounts routes"| node_authroutes
node_server -->|"mounts routes"| node_docs
node_server -->|"mounts routes"| node_folders
node_server -->|"mounts routes"| node_uploads

click node_reader "https://github.com/azaken1248/markdownviewer/blob/main/public/js/app.js"
click node_search "https://github.com/azaken1248/markdownviewer/blob/main/public/js/app/search.js"
click node_editing "https://github.com/azaken1248/markdownviewer/blob/main/public/js/app/page-edit.js"
click node_docs "https://github.com/azaken1248/markdownviewer/blob/main/lib/routes/docs.js"
click node_folders "https://github.com/azaken1248/markdownviewer/blob/main/lib/routes/folders.js"
click node_uploads "https://github.com/azaken1248/markdownviewer/blob/main/lib/routes/upload.js"
click node_authroutes "https://github.com/azaken1248/markdownviewer/blob/main/lib/routes/auth.js"
click node_auth "https://github.com/azaken1248/markdownviewer/blob/main/lib/auth.js"
click node_metadata "https://github.com/azaken1248/markdownviewer/blob/main/lib/db.js"
click node_shares "https://github.com/azaken1248/markdownviewer/blob/main/lib/routes/shares.js"
click node_savedlinks "https://github.com/azaken1248/markdownviewer/blob/main/lib/links.js"
click node_preview "https://github.com/azaken1248/markdownviewer/blob/main/lib/link-preview.js"
click node_markdown "https://github.com/azaken1248/markdownviewer/blob/main/public/js/markdown-core.js"
click node_diagrams "https://github.com/azaken1248/markdownviewer/blob/main/public/js/diagram-editor.js"
click node_notebooks "https://github.com/azaken1248/markdownviewer/blob/main/public/js/notebook-runtime.js"
click node_export "https://github.com/azaken1248/markdownviewer/blob/main/public/js/export.js"
click node_server "https://github.com/azaken1248/markdownviewer/blob/main/server.js"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_reader,node_search,node_editing,node_visitor toneBlue
class node_docs,node_folders,node_uploads,node_files toneAmber
class node_authroutes,node_auth,node_metadata,node_shares,node_savedlinks,node_preview toneMint
class node_markdown,node_diagrams,node_notebooks,node_export toneRose
class node_server toneIndigo
```

## Components

### Browser library

- [Library reader](https://github.com/azaken1248/markdownviewer/blob/main/public/js/app.js): `public/js/app.js`
- [Full-text search](https://github.com/azaken1248/markdownviewer/blob/main/public/js/app/search.js): `public/js/app/search.js`
- [In-place editing](https://github.com/azaken1248/markdownviewer/blob/main/public/js/app/page-edit.js): `public/js/app/page-edit.js`

### Document management

- [Document routes](https://github.com/azaken1248/markdownviewer/blob/main/lib/routes/docs.js): `lib/routes/docs.js`
- [Folder routes](https://github.com/azaken1248/markdownviewer/blob/main/lib/routes/folders.js): `lib/routes/folders.js`
- [Document uploads](https://github.com/azaken1248/markdownviewer/blob/main/lib/routes/upload.js): `lib/routes/upload.js`
- **Markdown files**

### Identity and sharing

- [Account routes](https://github.com/azaken1248/markdownviewer/blob/main/lib/routes/auth.js): `lib/routes/auth.js`
- [Authentication and roles](https://github.com/azaken1248/markdownviewer/blob/main/lib/auth.js): `lib/auth.js`
- [Application metadata](https://github.com/azaken1248/markdownviewer/blob/main/lib/db.js): `lib/db.js`
- [Share routes](https://github.com/azaken1248/markdownviewer/blob/main/lib/routes/shares.js): `lib/routes/shares.js`
- [Saved links](https://github.com/azaken1248/markdownviewer/blob/main/lib/links.js): `lib/links.js`
- [Link previews](https://github.com/azaken1248/markdownviewer/blob/main/lib/link-preview.js): `lib/link-preview.js`

### Rich content

- [Markdown rendering](https://github.com/azaken1248/markdownviewer/blob/main/public/js/markdown-core.js): `public/js/markdown-core.js`
- [Flowchart builder](https://github.com/azaken1248/markdownviewer/blob/main/public/js/diagram-editor.js): `public/js/diagram-editor.js`
- [Notebook execution](https://github.com/azaken1248/markdownviewer/blob/main/public/js/notebook-runtime.js): `public/js/notebook-runtime.js`
- [Document export](https://github.com/azaken1248/markdownviewer/blob/main/public/js/export.js): `public/js/export.js`

### Server runtime

- [Express application](https://github.com/azaken1248/markdownviewer/blob/main/server.js): `server.js`

### Other components

- **Library user**

## Connections

- Library user → Library reader: browses (evidence: `README.md`)
- Library reader → Document routes: opens documents
- Library reader → Full-text search: searches library (evidence: `README.md`)
- Full-text search → Document routes: requests search
- Library reader → In-place editing: edits in place (evidence: `README.md`)
- In-place editing → Document routes: writes changes
- Document routes → Markdown files: reads and writes (evidence: `lib/routes/docs.js`)
- Folder routes → Markdown files: moves directories (evidence: `lib/routes/folders.js`)
- Document uploads → Markdown files: stores documents
- Account routes → Authentication and roles: calls authentication (evidence: `lib/routes/auth.js`)
- Authentication and roles → Application metadata: queries accounts (evidence: `lib/auth.js`)
- Share routes → Application metadata: stores share metadata
- Saved links → Application metadata: stores link metadata (evidence: `lib/links.js`)
- Saved links → Link previews: fetches previews (evidence: `lib/links.js`)
- Library reader → Markdown rendering: renders content (evidence: `README.md`)
- Library reader → Flowchart builder: edits diagrams (evidence: `README.md`)
- Library reader → Notebook execution: runs notebook code (evidence: `README.md`)
- Library reader → Document export: exports documents
- Express application → Account routes: mounts routes (evidence: `server.js`)
- Express application → Document routes: mounts routes (evidence: `server.js`)
- Express application → Folder routes: mounts routes (evidence: `server.js`)
- Express application → Document uploads: mounts routes (evidence: `server.js`)
