O ideal é que o arquivo siga um padrão, o tipo eu acho que pouco importa, vai mudar a forma que tu vai fazer o parsing deles, eu costumo trabalhar com markdown ou mdx.
Vamos supor que tu tenha um arquivo de um projeto, tu pode definir um tipo de marcação para metadados.
"""
YAML Front Matter
https://stackoverflow.com/questions/44215896/markdown-metadata-format
Ou seja, tudo abaixo de determinado metado vai se refirir a algo, então quando tu for parsear o documento tu vai conseguir dividir melhor na estrutura que tu precisa enviar via api. Tem bastante parsers de markdown disponíveis e um uma forma que geradores de sites estáticos usam.