> ## Documentation Index
> Fetch the complete documentation index at: https://docs.markpdf.tech/llms.txt
> Use this file to discover all available pages before exploring further.

# Instalación

> Instale la biblioteca oficial de C++ para Flash PDF en Markdown.

# Instalación

`markpdf-cpp` es una biblioteca cliente de C++17 para API Flash PDF para Markdown, basada en [libcurl](https://curl.se/libcurl/) para HTTP transporte y [nlohmann/json](https://github.com/nlohmann/json) para JSON análisis de respuesta.

\##Requisitos

* Compilador con soporte C++17 (GCC 9+, Clang 10+, MSVC 2019+).
* [libcurl](https://curl.se/libcurl/) (con soporte TLS) instalado en el sistema.
* CMake 3.16 o superior.
* Una tecla API. Consulte [Autenticación](/docs/public/es/authentication).

## Instalar con CMake (`FetchContent`)

```cmake theme={null}
include(FetchContent)
FetchContent_Declare(
  markpdf-cpp
  GIT_REPOSITORY https://github.com/markpdf/markpdf-cpp.git
  GIT_TAG        v1.0.0
)
FetchContent_MakeAvailable(markpdf-cpp)

target_link_libraries(tu_app PRIVATE markpdf::markpdf)
```

## Instalar con vcpkg

```bash theme={null}
vcpkg install markpdf-cpp
```

```cmake theme={null}
find_package(markpdf-cpp CONFIG REQUIRED)
target_link_libraries(tu_app PRIVATE markpdf::markpdf)
```

## Instalar con Conan

```ini theme={null}
[requires]
markpdf-cpp/1.0.0

[generators]
CMakeDeps
CMakeToolchain
```

<Note>
  La biblioteca expone un modo *solo encabezado* (define `MARKPDF_HEADER_ONLY` antes de incluir `<markpdf/client.hpp>`) y una variante compilada estática/dinámica a través de CMake, para proyectos que prefieren no volver a compilar la implementación en cada unidad de traducción.
</Note>

## Configurar la clave API

```cpp theme={null}
#include <markpdf/client.hpp>
#include <cstdlib>

int main() {
    // From environment variable MARKPDF_API_KEY
    markpdf::Client client;

    // Or explicit
    markpdf::Client client2("YOUR_API_KEY");
}
```

<Warning>
  Nunca compile la clave API como literal en un binario que distribuya a los usuarios finales (aplicaciones de escritorio, firmware). Utilice un backend intermediario si el binario no es totalmente confiable.
</Warning>

## Siguiente paso

Continúe con [Inicio rápido](/docs/public/es/sdks/cpp/quickstart).
