research-portallisted

Build and manage a local MkDocs Material "research portal" over a folder of Typora/markdown research notes (e.g. ~/notes or a Dropbox-synced folder), keeping the original .md files untouched. Use this whenever the user wants to collect, browse, organize, or curate a folder of dated markdown notes into a searchable navigable site; wants a lighter local alternative to Obsidian / Notion / Outline / Logseq for their own notes; needs perfect LaTeX/math rendering in a notes site; wants notes grouped by project in a sidebar; or wants to tag/rename notes by project without breaking image links. Trigger even if they don't say "MkDocs" or "portal" but describe wanting to "정리해서 모아 보기", make a personal wiki, or render math from their note folder.
Axect/skills · ★ 2 · AI & Automation · score 75

Install: claude install-skill Axect/skills

# Research Portal Turn a folder of dated markdown notes into a local, searchable MkDocs Material site with project-grouped navigation and full LaTeX rendering, without ever modifying the source notes. The site is read/browse oriented; authoring stays in the user's existing editor (Typora), so the `.md` files remain the canonical source. ## When this fits (and when it doesn't) This is the right tool when notes are flat markdown files in a folder (often Dropbox-synced), named by date like `YYYYMMDD[_PROJECT].md`, with images in sibling `<stem>.assets/` folders. It deliberately avoids database-backed wikis (Outline needs Postgres/Redis/SSO; Notion is a SaaS DB) because those divorce content from the user's files and break the Typora workflow. If the user instead wants backlink/graph visualization, mention Quartz as a complement; this skill does not do graphs. ## Design choices (read `references/design.md` for the why) - `docs_dir` points straight at the notes folder. The site serves `.md`, `.assets/` images, and PDFs in place; originals are never touched. - Only three helper files land in the notes folder, all regenerable/deletable: `index.md` (home), `SUMMARY.md` (sidebar nav), `javascripts/mathjax.js`. - Math: `pymdownx.arithmatex` (generic) protects inline `$...$` from markdown, and MathJax 3 also scans raw `$$...$$` as a fallback because arithmatex's block processor does not descend into list items (Typora notes often nest display math under bullets). This com