**As** a user
**I want to** include long text custom fields in my work package description
**so that** can export the information

Current:

<figure class="table op-uc-figure_align-center op-uc-figure"><table class="op-uc-table"><tbody><tr class="op-uc-table--row"><td class="op-uc-table--cell"><figure class="image image_resized op-uc-figure" style="width:368px;"><div class="op-uc-figure--content"><img class="op-uc-image" src="/api/v3/attachments/798612/content"></div><figcaption class="op-uc-figure--description">Input</figcaption></figure></td></tr><tr class="op-uc-table--row"><td class="op-uc-table--cell"><figure class="image image_resized op-uc-figure" style="width:586px;"><div class="op-uc-figure--content"><img class="op-uc-image" src="/api/v3/attachments/798613/content"></div><figcaption class="op-uc-figure--description">PDF</figcaption></figure></td></tr></tbody></table></figure>

**Acceptance criteria**

* Begin of the insertionCustomEnd of the insertion Begin of the deletion Non-nested customEnd of the deletion long text fields Begin of the insertionand descriptionsEnd of the insertion referenced by a macro Begin of the deletion in a descriptionEnd of the deletion are included in the export.

* Begin of the insertionA fully supported position is: start of a line (see screenshot above)

* IfEnd of the insertion Begin of the deletion Supported positions areEnd of the deletion the Begin of the insertionmacro is inserted in the middleEnd of the insertion Begin of the deletion root levelEnd of the deletion of a Begin of the insertionline and the replacement contains Markdown structures likeEnd of the insertion Begin of the deletion document (butEnd of the deletion e.g. Begin of the insertionlists,End of the insertion Begin of the deletion NOTEnd of the deletion in Begin of the insertionthe PDF the replacement is on their own line
e.g. `This is a macro:projectValue:RichtText`
in PDF:&nbsp;
`This is a macro:`
`* List item`
`* List item`End of the insertion Begin of the deletion table cells)End of the deletion

* Begin of the insertionIn nested positions, e.g. **table cells**, macrosEnd of the insertion Begin of the deletion Nested positionsEnd of the deletion are Begin of the insertiononlyEnd of the insertion supported Begin of the deletion everywhereEnd of the deletion if the long text only includes basic text formatting (NOT images, tables, lists, Begin of the insertionetc.), otherwise a message &quot;Nested rich text embedding currently not supported in export&quot; is inserted instead End of the insertion Begin of the deletion etc.)End of the deletion


**Technical notes**

* &quot;Non-nested&quot; refers to macros like `workPackageValue:richtextfield` or `projectValue:richtextfield` are not inserted into another formatting, like tables, quotes, lists, etc. As _long text fields_ can contain all of those formatting structures themselves and even contain other rich text macros, which are not fully supported by the PDF ruby gem.


**Permissions and visibility considerations**

* _No changes required for permissions, handled as with other custom fields_


**Out of scope**

* Nested long text field macros with tables, images, etc.


**Note to the docs team**

[Documentation is updated](https://community.openproject.org/projects/openproject/work_packages/68540/activity#comment-1478928)