aarnphm.github.io

This repository powers a sophisticated digital garden built on the Quartz v4 static site generator framework. It is designed for researchers, developers, and thinkers who require a highly extensible documentation and knowledge management platform. The setup prioritizes academic and technical note-taking, enabling advanced visual representations and complex formatting directly within a markdown-based workflow.

The system integrates seamlessly with Obsidian, allowing for a hybrid environment where local development in Obsidian plugins (such as heading-gh, metadata, and sidenotes) translates into a polished, high-performance web presence. The infrastructure includes custom remark parsers for OFM compatibility, facilitating complex wikilinks and callout structures essential for interconnected knowledge graphs. Users benefit from specialized rendering engines for TikZ graphics and algorithmic pseudocode, making it an ideal choice for technical documentation, mathematical notes, or computer science research.

• Advanced Markdown Extensions: Custom remark parsers supporting OFM wikilinks, callouts, and enhanced text hierarchy.
• Visual & Technical Rendering: Native support for TikZ/LaTeX diagrams and high-fidelity pseudocode blocks with copy functionality.
• Interactive Elements: Telescopic text support for progressive disclosure of information, Gaussian-scaling Tables of Contents, and collapsible headers.
• Workflow Automation: Pre-configured build pipelines using pnpm, TypeScript (tsx), and local development runners that bridge Obsidian and the web output.
• Obsidian Ecosystem: Includes internal tooling for managing Obsidian plugins and local dev servers that mirror the live site behavior.

When using this skill, ensure you have pnpm installed, as the build process relies on a custom pnpm swarm command to manage the development cycle. Input consists primarily of markdown files stored within the content/ directory, which are processed into a static site. Outputs include a reactive web interface that features a reader view, TOC navigation, and responsive typography. Be aware that TikZ rendering may require specific alt-tag URI configurations due to known upstream bugs in node ports. Users should maintain structural consistency in the content/ folder to ensure that internal wikilinks and metadata plugins function correctly during the build process.