Why You Need to Convert Your PDF Whitepaper to iXBRL
If you already have a crypto-asset whitepaper in PDF format, you are not starting from zero. Under the Markets in Crypto-Assets Regulation (MiCAR, EU 2023/1114), all whitepapers must be submitted to a national competent authority (NCA) in iXBRL format. PDF is not accepted. But converting your existing PDF to iXBRL allows you to preserve the content you have already invested in while meeting the regulatory requirement.
Many token issuers have spent significant resources creating detailed whitepapers that accurately describe their project, technology, and tokenomics. A PDF-to-iXBRL conversion preserves this work. You do not need to rewrite your whitepaper. You need to restructure it into the format that EU regulators require.
What Happens During a PDF to iXBRL Conversion?
Converting a PDF to iXBRL is not a simple file format conversion like turning a Word document into a PDF. It is a structured transformation that involves several distinct steps:
1. Content Extraction
The first step is extracting all text, tables, and data from your PDF. PDFs store content as visual elements rather than structured data, which means the extraction process needs to reconstruct the logical structure of your document: headings, paragraphs, lists, tables, and their relationships.
2. Structural Mapping to MiCAR ITS Requirements
Once the content is extracted, it must be mapped to the structure required by the Implementing Technical Standards (ITS 2024/2984). The ITS defines exactly what information a MiCAR whitepaper must contain and in what order. Your existing PDF may organize information differently, so the content needs to be restructured to match these requirements.
3. Gap Analysis
Most existing crypto-asset whitepapers were not written with MiCAR in mind. A gap analysis identifies any information that is missing from your PDF but required by the ITS. Common gaps include sustainability indicators (energy consumption data), specific risk disclosures mandated by MiCAR, and detailed information about the consensus mechanism used by the underlying DLT.
4. iXBRL Tagging with the ESMA 2025 Taxonomy
This is the core of the conversion process. Every required data point in your whitepaper is tagged with the corresponding concept from the ESMA 2025 taxonomy. Tags are embedded directly into the HTML structure of the iXBRL document. For example, your project's legal name, the token's consensus mechanism type, and each sustainability indicator all receive their own taxonomy tags.
5. Branding and Styling
Because iXBRL is based on HTML, the converted document can retain your brand identity. Colors, fonts, logos, and layout can all be preserved. The result looks like a professional web page, not a raw data file.
6. Validation
The final iXBRL file is validated against the ESMA taxonomy schema. This validation checks that all required tags are present, data types are correct, and the file structure conforms to the specification. A validated file is ready for submission to any EU national competent authority.
Common Challenges When Converting PDF to iXBRL
PDF-to-iXBRL conversion is not trivial. Here are the most common challenges:
- PDF structure loss: PDFs do not preserve document structure the way HTML does. Tables may be stored as positioned text elements rather than actual table data. Complex layouts can make extraction difficult.
- Missing MiCAR-required information: Most existing whitepapers predate MiCAR and lack required disclosures like sustainability indicators or specific risk warnings. These gaps must be filled before the conversion can be completed.
- Taxonomy mapping complexity: The ESMA taxonomy contains hundreds of concepts. Mapping your existing content to the correct taxonomy tags requires expertise in both the regulatory requirements and the XBRL standard.
- Validation errors: iXBRL files must pass strict validation. Even small issues like a missing required tag or an incorrect data type will cause validation failure.
How Long Does a PDF to iXBRL Conversion Take?
A typical conversion takes approximately one week from the moment we receive your PDF and any additional information needed to fill MiCAR gaps. The timeline depends on:
- The complexity and length of your existing whitepaper
- How many information gaps need to be filled
- How quickly you can provide any additional data we request
Can You Also Convert HTML or Word Documents to iXBRL?
Yes. While PDF is the most common format, we also convert HTML and Word (.docx) whitepapers to iXBRL. HTML conversions are particularly straightforward since iXBRL is itself an extension of HTML, so the content structure is already in a compatible format. Word documents are also supported and follow a similar process to PDF conversion.
Regardless of your input format, the output is the same: a single, validated iXBRL file tagged with the ESMA 2025 taxonomy and ready for NCA submission.
What You Receive After Conversion
After the conversion is complete, you receive:
- The final iXBRL file, ready for NCA submission
- A validation report confirming all taxonomy requirements are met
- A review period to verify content accuracy
Ready to convert your whitepaper?
Send us your PDF, HTML, or Word whitepaper and we will deliver a validated iXBRL file ready for NCA submission. We also offer a MiCAR notification service if you need help with the submission itself, or a whitepaper drafting service if you are starting from scratch.


