# 📚 ezbib Documentation

**Universal, zero-dependency CLI tool and Python library to convert ORCID profiles and DOIs into clean BibTeX, Markdown, and formatted academic citations.**

Welcome to the official documentation for `ezbib`.

Raw bibliographic metadata from academic APIs is frequently inconsistent, filled with XML fragments, cluttered with unreviewed preprints, and cumbersome to organize. `ezbib` was built specifically for researchers, lab managers, and scientific developers who need clean, publication-ready records without installing heavy dependencies.


:::{grid-item}
**🌐 Built-in Web GUI**  
Run `ezbib web` to instantly launch a beautiful browser-based interface locally!
:::
::::{grid} 1 2 2 2
:gutter: 3

:::{grid-item}
**⚡ Zero Dependencies**  
Built 100% on the Python Standard Library. No third-party packages required.
:::

:::{grid-item}
**⌨️ Interactive Mode**  
Paste complex DOIs with special characters without breaking your terminal shell.
:::

:::{grid-item}
**🧹 LaTeX Sanitization**  
Auto-converts messy MathML (`<mml:math>`) into clean standard LaTeX.
:::

:::{grid-item}
**🧠 Smart Deduplication**  
Intelligently suppresses arXiv/bioRxiv preprints if peer-reviewed versions exist.
:::
::::

## 📖 Table of Contents

```{toctree}
:maxdepth: 2
:hidden: true

installation
usage
api
faq
```

::::{grid} 1 1 2 2
:gutter: 3

:::{grid-item-card} 🚀 Getting Started
:link: installation
:link-type: doc
:class-card: shadow

Learn how to install `ezbib` globally or run it directly without any installation.
:::

:::{grid-item-card} 💻 Usage & Recipes
:link: usage
:link-type: doc
:class-card: shadow

Explore common CLI workflows, citation formats, and Markdown CV generation.
:::

:::{grid-item-card} 🐍 Python API
:link: api
:link-type: doc
:class-card: shadow

Integrate `ezbib` programmatically into your own Python applications.
:::

:::{grid-item-card} ❓ FAQ
:link: faq
:link-type: doc
:class-card: shadow

Answers to questions about ORCID API limits, missing DOIs, and citation styles.
:::
::::