From eb849f6604c7dcc0e96d68f4851e52e253b9f0e5 Mon Sep 17 00:00:00 2001
From: Sylvain Gugger <35901082+sgugger@users.noreply.github.com>
Date: Tue, 20 Jun 2023 18:07:47 -0400
Subject: [PATCH] Migrate doc files to Markdown. (#24376)

* Rename index.mdx to index.md

* With saved modifs

* Address review comment

* Treat all files

* .mdx -> .md

* Remove special char

* Update utils/tests_fetcher.py

Co-authored-by: Lysandre Debut <lysandre.debut@reseau.eseo.fr>

---------

Co-authored-by: Lysandre Debut <lysandre.debut@reseau.eseo.fr>
---
 .circleci/create_circleci_config.py           |  2 +-
 .github/ISSUE_TEMPLATE/i18n.md                | 20 +++++------
 .github/workflows/doctests.yml                |  2 +-
 docs/README.md                                |  8 ++---
 .../de/{accelerate.mdx => accelerate.md}      |  4 +++
 ...ass_tutorial.mdx => autoclass_tutorial.md} |  4 +++
 docs/source/de/{index.mdx => index.md}        |  4 +++
 .../de/{installation.mdx => installation.md}  |  4 +++
 .../{model_sharing.mdx => model_sharing.md}   |  4 +++
 ...line_tutorial.mdx => pipeline_tutorial.md} |  4 +++
 .../{preprocessing.mdx => preprocessing.md}   |  4 +++
 .../source/de/{quicktour.mdx => quicktour.md} |  4 +++
 docs/source/de/{training.mdx => training.md}  |  4 +++
 .../en/{accelerate.mdx => accelerate.md}      |  4 +++
 .../{add_new_model.mdx => add_new_model.md}   |  6 +++-
 ...d_new_pipeline.mdx => add_new_pipeline.md} |  4 +++
 ...flow_model.mdx => add_tensorflow_model.md} | 10 ++++--
 .../source/en/{attention.mdx => attention.md} |  4 +++
 ...ass_tutorial.mdx => autoclass_tutorial.md} |  4 +++
 .../en/{benchmarks.mdx => benchmarks.md}      |  4 +++
 .../source/en/{bertology.mdx => bertology.md} |  4 +++
 .../en/{big_models.mdx => big_models.md}      |  4 +++
 .../source/en/{community.mdx => community.md} |  6 +++-
 .../{create_a_model.mdx => create_a_model.md} |  4 +++
 .../{custom_models.mdx => custom_models.md}   |  4 +++
 .../en/{custom_tools.mdx => custom_tools.md}  |  4 +++
 .../source/en/{debugging.mdx => debugging.md} |  4 +++
 ...fast_tokenizers.mdx => fast_tokenizers.md} |  4 +++
 ...trategies.mdx => generation_strategies.md} |  6 +++-
 docs/source/en/{glossary.mdx => glossary.md}  |  4 +++
 .../source/en/{hpo_train.mdx => hpo_train.md} |  4 +++
 docs/source/en/{index.mdx => index.md}        |  3 ++
 .../en/{installation.mdx => installation.md}  |  4 +++
 .../{audio_utils.mdx => audio_utils.md}       |  4 +++
 .../{file_utils.mdx => file_utils.md}         |  4 +++
 ...neration_utils.mdx => generation_utils.md} |  4 +++
 ...ng_utils.mdx => image_processing_utils.md} |  4 +++
 .../{modeling_utils.mdx => modeling_utils.md} |  4 +++
 ...pipelines_utils.mdx => pipelines_utils.md} |  4 +++
 ..._series_utils.mdx => time_series_utils.md} |  4 +++
 ...zation_utils.mdx => tokenization_utils.md} |  4 +++
 .../{trainer_utils.mdx => trainer_utils.md}   |  4 +++
 .../en/main_classes/{agent.mdx => agent.md}   |  4 +++
 .../{callback.mdx => callback.md}             |  4 +++
 .../{configuration.mdx => configuration.md}   |  4 +++
 .../{data_collator.mdx => data_collator.md}   |  4 +++
 .../{deepspeed.mdx => deepspeed.md}           |  4 +++
 ...ure_extractor.mdx => feature_extractor.md} |  4 +++
 ...image_processor.mdx => image_processor.md} |  4 +++
 ...keras_callbacks.mdx => keras_callbacks.md} |  4 +++
 .../main_classes/{logging.mdx => logging.md}  |  4 +++
 .../en/main_classes/{model.mdx => model.md}   |  4 +++
 .../en/main_classes/{onnx.mdx => onnx.md}     |  4 +++
 ...r_schedules.mdx => optimizer_schedules.md} |  4 +++
 .../en/main_classes/{output.mdx => output.md} |  4 +++
 .../{pipelines.mdx => pipelines.md}           |  4 +++
 .../{processors.mdx => processors.md}         |  4 +++
 .../{quantization.mdx => quantization.md}     |  4 +++
 ...text_generation.mdx => text_generation.md} |  4 +++
 .../{tokenizer.mdx => tokenizer.md}           |  4 +++
 .../main_classes/{trainer.mdx => trainer.md}  |  4 +++
 .../en/model_doc/{albert.mdx => albert.md}    |  4 +++
 .../en/model_doc/{align.mdx => align.md}      |  4 +++
 .../en/model_doc/{altclip.mdx => altclip.md}  |  4 +++
 ...r.mdx => audio-spectrogram-transformer.md} |  4 +++
 .../source/en/model_doc/{auto.mdx => auto.md} |  4 +++
 .../{autoformer.mdx => autoformer.md}         |  4 +++
 .../source/en/model_doc/{bart.mdx => bart.md} |  4 +++
 .../en/model_doc/{barthez.mdx => barthez.md}  |  4 +++
 .../en/model_doc/{bartpho.mdx => bartpho.md}  |  4 +++
 .../source/en/model_doc/{beit.mdx => beit.md} |  4 +++
 ...bert-generation.mdx => bert-generation.md} |  4 +++
 .../{bert-japanese.mdx => bert-japanese.md}   |  4 +++
 .../source/en/model_doc/{bert.mdx => bert.md} |  4 +++
 .../model_doc/{bertweet.mdx => bertweet.md}   |  4 +++
 .../model_doc/{big_bird.mdx => big_bird.md}   |  4 +++
 ...bigbird_pegasus.mdx => bigbird_pegasus.md} |  4 +++
 .../en/model_doc/{biogpt.mdx => biogpt.md}    |  4 +++
 docs/source/en/model_doc/{bit.mdx => bit.md}  |  4 +++
 ...enderbot-small.mdx => blenderbot-small.md} |  4 +++
 .../{blenderbot.mdx => blenderbot.md}         |  4 +++
 .../en/model_doc/{blip-2.mdx => blip-2.md}    |  4 +++
 .../source/en/model_doc/{blip.mdx => blip.md} |  4 +++
 .../en/model_doc/{bloom.mdx => bloom.md}      |  4 +++
 .../source/en/model_doc/{bort.mdx => bort.md} |  4 +++
 .../{bridgetower.mdx => bridgetower.md}       |  4 +++
 .../source/en/model_doc/{byt5.mdx => byt5.md} |  4 +++
 .../model_doc/{camembert.mdx => camembert.md} |  4 +++
 .../en/model_doc/{canine.mdx => canine.md}    |  4 +++
 .../{chinese_clip.mdx => chinese_clip.md}     |  4 +++
 .../source/en/model_doc/{clap.mdx => clap.md} |  4 +++
 .../source/en/model_doc/{clip.mdx => clip.md} |  4 +++
 .../en/model_doc/{clipseg.mdx => clipseg.md}  |  4 +++
 .../en/model_doc/{codegen.mdx => codegen.md}  |  4 +++
 ...nditional_detr.mdx => conditional_detr.md} |  4 +++
 .../model_doc/{convbert.mdx => convbert.md}   |  4 +++
 .../model_doc/{convnext.mdx => convnext.md}   |  4 +++
 .../{convnextv2.mdx => convnextv2.md}         |  4 +++
 docs/source/en/model_doc/{cpm.mdx => cpm.md}  |  4 +++
 .../en/model_doc/{cpmant.mdx => cpmant.md}    |  4 +++
 .../source/en/model_doc/{ctrl.mdx => ctrl.md} |  4 +++
 docs/source/en/model_doc/{cvt.mdx => cvt.md}  |  4 +++
 .../model_doc/{data2vec.mdx => data2vec.md}   |  4 +++
 .../{deberta-v2.mdx => deberta-v2.md}         |  4 +++
 .../en/model_doc/{deberta.mdx => deberta.md}  |  4 +++
 ...ransformer.mdx => decision_transformer.md} |  4 +++
 ...deformable_detr.mdx => deformable_detr.md} |  4 +++
 .../source/en/model_doc/{deit.mdx => deit.md} |  4 +++
 .../en/model_doc/{deplot.mdx => deplot.md}    |  4 +++
 .../source/en/model_doc/{deta.mdx => deta.md} |  4 +++
 .../source/en/model_doc/{detr.mdx => detr.md} |  4 +++
 .../model_doc/{dialogpt.mdx => dialogpt.md}   |  4 +++
 .../en/model_doc/{dinat.mdx => dinat.md}      |  4 +++
 .../{distilbert.mdx => distilbert.md}         |  4 +++
 docs/source/en/model_doc/{dit.mdx => dit.md}  |  4 +++
 .../en/model_doc/{donut.mdx => donut.md}      |  4 +++
 docs/source/en/model_doc/{dpr.mdx => dpr.md}  |  4 +++
 docs/source/en/model_doc/{dpt.mdx => dpt.md}  |  4 +++
 ...efficientformer.mdx => efficientformer.md} |  4 +++
 .../{efficientnet.mdx => efficientnet.md}     |  4 +++
 .../en/model_doc/{electra.mdx => electra.md}  |  4 +++
 .../en/model_doc/{encodec.mdx => encodec.md}  |  4 +++
 ...encoder-decoder.mdx => encoder-decoder.md} |  4 +++
 .../en/model_doc/{ernie.mdx => ernie.md}      |  4 +++
 .../en/model_doc/{ernie_m.mdx => ernie_m.md}  |  4 +++
 docs/source/en/model_doc/{esm.mdx => esm.md}  |  4 +++
 .../en/model_doc/{flan-t5.mdx => flan-t5.md}  |  4 +++
 .../model_doc/{flan-ul2.mdx => flan-ul2.md}   |  4 +++
 .../model_doc/{flaubert.mdx => flaubert.md}   |  4 +++
 .../en/model_doc/{flava.mdx => flava.md}      |  4 +++
 .../source/en/model_doc/{fnet.mdx => fnet.md} |  4 +++
 .../model_doc/{focalnet.mdx => focalnet.md}   |  4 +++
 .../source/en/model_doc/{fsmt.mdx => fsmt.md} |  4 +++
 .../en/model_doc/{funnel.mdx => funnel.md}    |  4 +++
 docs/source/en/model_doc/{git.mdx => git.md}  |  4 +++
 .../source/en/model_doc/{glpn.mdx => glpn.md} |  4 +++
 .../en/model_doc/{gpt-sw3.mdx => gpt-sw3.md}  |  4 +++
 .../source/en/model_doc/{gpt2.mdx => gpt2.md} |  4 +++
 .../{gpt_bigcode.mdx => gpt_bigcode.md}       |  4 +++
 .../en/model_doc/{gpt_neo.mdx => gpt_neo.md}  |  4 +++
 .../model_doc/{gpt_neox.mdx => gpt_neox.md}   |  4 +++
 ...neox_japanese.mdx => gpt_neox_japanese.md} |  4 +++
 .../source/en/model_doc/{gptj.mdx => gptj.md} |  4 +++
 ...gptsan-japanese.mdx => gptsan-japanese.md} |  4 +++
 .../{graphormer.mdx => graphormer.md}         |  4 +++
 .../model_doc/{groupvit.mdx => groupvit.md}   |  4 +++
 .../en/model_doc/{herbert.mdx => herbert.md}  |  4 +++
 .../en/model_doc/{hubert.mdx => hubert.md}    |  4 +++
 .../en/model_doc/{ibert.mdx => ibert.md}      |  4 +++
 .../model_doc/{imagegpt.mdx => imagegpt.md}   |  4 +++
 .../model_doc/{informer.mdx => informer.md}   |  4 +++
 .../en/model_doc/{jukebox.mdx => jukebox.md}  |  4 +++
 .../model_doc/{layoutlm.mdx => layoutlm.md}   |  4 +++
 .../{layoutlmv2.mdx => layoutlmv2.md}         |  4 +++
 .../{layoutlmv3.mdx => layoutlmv3.md}         |  4 +++
 .../model_doc/{layoutxlm.mdx => layoutxlm.md} |  4 +++
 docs/source/en/model_doc/{led.mdx => led.md}  |  4 +++
 .../en/model_doc/{levit.mdx => levit.md}      |  4 +++
 .../source/en/model_doc/{lilt.mdx => lilt.md} |  4 +++
 .../en/model_doc/{llama.mdx => llama.md}      |  4 +++
 .../{longformer.mdx => longformer.md}         |  4 +++
 .../en/model_doc/{longt5.mdx => longt5.md}    |  4 +++
 .../source/en/model_doc/{luke.mdx => luke.md} |  4 +++
 .../en/model_doc/{lxmert.mdx => lxmert.md}    |  4 +++
 .../en/model_doc/{m2m_100.mdx => m2m_100.md}  |  4 +++
 .../en/model_doc/{marian.mdx => marian.md}    |  4 +++
 .../model_doc/{markuplm.mdx => markuplm.md}   |  4 +++
 .../{mask2former.mdx => mask2former.md}       |  4 +++
 .../{maskformer.mdx => maskformer.md}         |  4 +++
 .../en/model_doc/{matcha.mdx => matcha.md}    |  4 +++
 .../en/model_doc/{mbart.mdx => mbart.md}      |  4 +++
 .../en/model_doc/{mctct.mdx => mctct.md}      |  4 +++
 .../source/en/model_doc/{mega.mdx => mega.md} |  4 +++
 .../{megatron-bert.mdx => megatron-bert.md}   |  4 +++
 .../{megatron_gpt2.mdx => megatron_gpt2.md}   |  4 +++
 .../en/model_doc/{mgp-str.mdx => mgp-str.md}  |  4 +++
 .../en/model_doc/{mluke.mdx => mluke.md}      |  4 +++
 docs/source/en/model_doc/{mms.mdx => mms.md}  |  4 +++
 .../{mobilebert.mdx => mobilebert.md}         |  4 +++
 .../{mobilenet_v1.mdx => mobilenet_v1.md}     |  4 +++
 .../{mobilenet_v2.mdx => mobilenet_v2.md}     |  4 +++
 .../model_doc/{mobilevit.mdx => mobilevit.md} |  4 +++
 .../{mobilevitv2.mdx => mobilevitv2.md}       |  4 +++
 .../en/model_doc/{mpnet.mdx => mpnet.md}      |  4 +++
 docs/source/en/model_doc/{mt5.mdx => mt5.md}  |  4 +++
 docs/source/en/model_doc/{mvp.mdx => mvp.md}  |  4 +++
 docs/source/en/model_doc/{nat.mdx => nat.md}  |  4 +++
 .../en/model_doc/{nezha.mdx => nezha.md}      |  4 +++
 .../model_doc/{nllb-moe.mdx => nllb-moe.md}   |  4 +++
 .../source/en/model_doc/{nllb.mdx => nllb.md} |  4 +++
 .../{nystromformer.mdx => nystromformer.md}   |  4 +++
 .../model_doc/{oneformer.mdx => oneformer.md} |  4 +++
 .../{open-llama.mdx => open-llama.md}         |  4 +++
 .../{openai-gpt.mdx => openai-gpt.md}         |  4 +++
 docs/source/en/model_doc/{opt.mdx => opt.md}  |  6 +++-
 .../en/model_doc/{owlvit.mdx => owlvit.md}    |  4 +++
 .../en/model_doc/{pegasus.mdx => pegasus.md}  |  4 +++
 .../model_doc/{pegasus_x.mdx => pegasus_x.md} |  4 +++
 .../model_doc/{perceiver.mdx => perceiver.md} |  4 +++
 .../en/model_doc/{phobert.mdx => phobert.md}  |  4 +++
 .../{pix2struct.mdx => pix2struct.md}         |  4 +++
 .../en/model_doc/{plbart.mdx => plbart.md}    |  4 +++
 .../{poolformer.mdx => poolformer.md}         |  4 +++
 .../{prophetnet.mdx => prophetnet.md}         |  4 +++
 .../en/model_doc/{qdqbert.mdx => qdqbert.md}  |  4 +++
 docs/source/en/model_doc/{rag.mdx => rag.md}  |  4 +++
 .../en/model_doc/{realm.mdx => realm.md}      |  4 +++
 .../model_doc/{reformer.mdx => reformer.md}   |  4 +++
 .../en/model_doc/{regnet.mdx => regnet.md}    |  4 +++
 .../en/model_doc/{rembert.mdx => rembert.md}  |  4 +++
 .../en/model_doc/{resnet.mdx => resnet.md}    |  4 +++
 .../model_doc/{retribert.mdx => retribert.md} |  4 +++
 ...elayernorm.mdx => roberta-prelayernorm.md} |  4 +++
 .../en/model_doc/{roberta.mdx => roberta.md}  |  4 +++
 .../model_doc/{roc_bert.mdx => roc_bert.md}   |  4 +++
 .../model_doc/{roformer.mdx => roformer.md}   |  4 +++
 .../source/en/model_doc/{rwkv.mdx => rwkv.md} |  4 +++
 docs/source/en/model_doc/{sam.mdx => sam.md}  |  4 +++
 .../model_doc/{segformer.mdx => segformer.md} |  4 +++
 .../en/model_doc/{sew-d.mdx => sew-d.md}      |  4 +++
 docs/source/en/model_doc/{sew.mdx => sew.md}  |  4 +++
 ...-decoder.mdx => speech-encoder-decoder.md} |  4 +++
 .../{speech_to_text.mdx => speech_to_text.md} |  4 +++
 ...eech_to_text_2.mdx => speech_to_text_2.md} |  4 +++
 .../model_doc/{speecht5.mdx => speecht5.md}   |  4 +++
 .../model_doc/{splinter.mdx => splinter.md}   |  4 +++
 .../{squeezebert.mdx => squeezebert.md}       |  4 +++
 .../{swiftformer.mdx => swiftformer.md}       |  4 +++
 .../source/en/model_doc/{swin.mdx => swin.md} |  4 +++
 .../en/model_doc/{swin2sr.mdx => swin2sr.md}  |  4 +++
 .../en/model_doc/{swinv2.mdx => swinv2.md}    |  4 +++
 ...ransformers.mdx => switch_transformers.md} |  4 +++
 docs/source/en/model_doc/{t5.mdx => t5.md}    |  4 +++
 .../en/model_doc/{t5v1.1.mdx => t5v1.1.md}    |  4 +++
 ...e-transformer.mdx => table-transformer.md} |  4 +++
 .../en/model_doc/{tapas.mdx => tapas.md}      |  4 +++
 .../en/model_doc/{tapex.mdx => tapex.md}      |  4 +++
 ...sformer.mdx => time_series_transformer.md} |  4 +++
 .../{timesformer.mdx => timesformer.md}       |  4 +++
 ...nsformer.mdx => trajectory_transformer.md} |  4 +++
 .../{transfo-xl.mdx => transfo-xl.md}         |  4 +++
 .../en/model_doc/{trocr.mdx => trocr.md}      |  4 +++
 .../source/en/model_doc/{tvlt.mdx => tvlt.md} |  4 +++
 docs/source/en/model_doc/{ul2.mdx => ul2.md}  |  4 +++
 .../{unispeech-sat.mdx => unispeech-sat.md}   |  4 +++
 .../model_doc/{unispeech.mdx => unispeech.md} |  4 +++
 .../en/model_doc/{upernet.mdx => upernet.md}  |  4 +++
 docs/source/en/model_doc/{van.mdx => van.md}  |  4 +++
 .../model_doc/{videomae.mdx => videomae.md}   |  4 +++
 .../source/en/model_doc/{vilt.mdx => vilt.md} |  4 +++
 ...-decoder.mdx => vision-encoder-decoder.md} |  4 +++
 ...ncoder.mdx => vision-text-dual-encoder.md} |  4 +++
 .../{visual_bert.mdx => visual_bert.md}       |  4 +++
 docs/source/en/model_doc/{vit.mdx => vit.md}  |  4 +++
 .../{vit_hybrid.mdx => vit_hybrid.md}         |  4 +++
 .../en/model_doc/{vit_mae.mdx => vit_mae.md}  |  4 +++
 .../en/model_doc/{vit_msn.mdx => vit_msn.md}  |  4 +++
 ...c2-conformer.mdx => wav2vec2-conformer.md} |  4 +++
 .../model_doc/{wav2vec2.mdx => wav2vec2.md}   |  4 +++
 ...v2vec2_phoneme.mdx => wav2vec2_phoneme.md} |  4 +++
 .../en/model_doc/{wavlm.mdx => wavlm.md}      |  4 +++
 .../en/model_doc/{whisper.mdx => whisper.md}  |  4 +++
 .../en/model_doc/{xclip.mdx => xclip.md}      |  4 +++
 .../source/en/model_doc/{xglm.mdx => xglm.md} |  4 +++
 .../{xlm-prophetnet.mdx => xlm-prophetnet.md} |  4 +++
 .../{xlm-roberta-xl.mdx => xlm-roberta-xl.md} |  4 +++
 .../{xlm-roberta.mdx => xlm-roberta.md}       |  4 +++
 .../en/model_doc/{xlm-v.mdx => xlm-v.md}      |  4 +++
 docs/source/en/model_doc/{xlm.mdx => xlm.md}  |  4 +++
 .../en/model_doc/{xlnet.mdx => xlnet.md}      |  4 +++
 .../en/model_doc/{xls_r.mdx => xls_r.md}      |  4 +++
 .../{xlsr_wav2vec2.mdx => xlsr_wav2vec2.md}   |  4 +++
 .../source/en/model_doc/{xmod.mdx => xmod.md} |  4 +++
 .../en/model_doc/{yolos.mdx => yolos.md}      |  4 +++
 .../source/en/model_doc/{yoso.mdx => yoso.md} |  4 +++
 .../{model_sharing.mdx => model_sharing.md}   |  4 +++
 .../{model_summary.mdx => model_summary.md}   |  4 +++
 .../en/{multilingual.mdx => multilingual.md}  |  4 +++
 .../{pad_truncation.mdx => pad_truncation.md} |  4 +++
 .../{perf_hardware.mdx => perf_hardware.md}   |  4 +++
 .../{perf_infer_cpu.mdx => perf_infer_cpu.md} |  4 +++
 ...er_gpu_many.mdx => perf_infer_gpu_many.md} |  4 +++
 ...nfer_gpu_one.mdx => perf_infer_gpu_one.md} |  4 +++
 ...nfer_special.mdx => perf_infer_special.md} |  4 +++
 .../{perf_train_cpu.mdx => perf_train_cpu.md} |  4 +++
 ...in_cpu_many.mdx => perf_train_cpu_many.md} |  4 +++
 ...in_gpu_many.mdx => perf_train_gpu_many.md} |  4 +++
 ...rain_gpu_one.mdx => perf_train_gpu_one.md} |  4 +++
 ...rain_special.mdx => perf_train_special.md} |  4 +++
 .../{perf_train_tpu.mdx => perf_train_tpu.md} |  4 +++
 ..._train_tpu_tf.mdx => perf_train_tpu_tf.md} |  4 +++
 .../en/{performance.mdx => performance.md}    |  4 +++
 .../en/{perplexity.mdx => perplexity.md}      |  4 +++
 .../en/{philosophy.mdx => philosophy.md}      |  4 +++
 ...line_tutorial.mdx => pipeline_tutorial.md} |  4 +++
 ...ne_webserver.mdx => pipeline_webserver.md} |  4 +++
 .../source/en/{pr_checks.mdx => pr_checks.md} |  4 +++
 .../{preprocessing.mdx => preprocessing.md}   |  4 +++
 .../source/en/{quicktour.mdx => quicktour.md} |  4 +++
 .../en/{run_scripts.mdx => run_scripts.md}    |  4 +++
 .../source/en/{sagemaker.mdx => sagemaker.md} |  4 +++
 .../{serialization.mdx => serialization.md}   |  4 +++
 .../en/{task_summary.mdx => task_summary.md}  |  4 +++
 docs/source/en/tasks/{asr.mdx => asr.md}      |  4 +++
 ...sification.mdx => audio_classification.md} |  4 +++
 ...ing.mdx => document_question_answering.md} |  4 +++
 ...age_captioning.mdx => image_captioning.md} |  4 +++
 ...sification.mdx => image_classification.md} |  4 +++
 ...uage_modeling.mdx => language_modeling.md} |  4 +++
 ...deling.mdx => masked_language_modeling.md} |  4 +++
 ...tion.mdx => monocular_depth_estimation.md} |  4 +++
 ...multiple_choice.mdx => multiple_choice.md} |  4 +++
 ...ject_detection.mdx => object_detection.md} |  4 +++
 ...on_answering.mdx => question_answering.md} |  4 +++
 ...mentation.mdx => semantic_segmentation.md} |  4 +++
 ...ication.mdx => sequence_classification.md} |  4 +++
 .../{summarization.mdx => summarization.md}   |  4 +++
 .../{text-to-speech.mdx => text-to-speech.md} |  4 +++
 ...sification.mdx => token_classification.md} |  4 +++
 .../tasks/{translation.mdx => translation.md} |  4 +++
 ...sification.mdx => video_classification.md} |  4 +++
 ....mdx => zero_shot_image_classification.md} |  4 +++
 ...tion.mdx => zero_shot_object_detection.md} |  4 +++
 ...tasks_explained.mdx => tasks_explained.md} |  4 +++
 docs/source/en/{testing.mdx => testing.md}    |  6 +++-
 docs/source/en/{tf_xla.mdx => tf_xla.md}      |  4 +++
 docs/source/en/{tflite.mdx => tflite.md}      |  4 +++
 ...nizer_summary.mdx => tokenizer_summary.md} |  4 +++
 .../en/{torchscript.mdx => torchscript.md}    |  4 +++
 docs/source/en/{training.mdx => training.md}  |  4 +++
 ...mers_agents.mdx => transformers_agents.md} |  4 +++
 ...troubleshooting.mdx => troubleshooting.md} |  4 +++
 .../es/{accelerate.mdx => accelerate.md}      |  4 +++
 ...d_new_pipeline.mdx => add_new_pipeline.md} |  4 +++
 ...ass_tutorial.mdx => autoclass_tutorial.md} |  4 +++
 .../source/es/{bertology.mdx => bertology.md} |  4 +++
 .../source/es/{community.mdx => community.md} |  4 +++
 ...ls.mdx => converting_tensorflow_models.md} |  4 +++
 .../{create_a_model.mdx => create_a_model.md} |  4 +++
 .../{custom_models.mdx => custom_models.md}   |  4 +++
 .../source/es/{debugging.mdx => debugging.md} |  4 +++
 ...fast_tokenizers.mdx => fast_tokenizers.md} |  4 +++
 docs/source/es/{index.mdx => index.md}        |  4 +++
 .../es/{installation.mdx => installation.md}  |  4 +++
 .../{model_sharing.mdx => model_sharing.md}   |  4 +++
 .../es/{multilingual.mdx => multilingual.md}  |  4 +++
 .../es/{philosophy.mdx => philosophy.md}      |  4 +++
 ...line_tutorial.mdx => pipeline_tutorial.md} |  4 +++
 .../source/es/{pr_checks.mdx => pr_checks.md} |  4 +++
 .../{preprocessing.mdx => preprocessing.md}   |  4 +++
 .../source/es/{quicktour.mdx => quicktour.md} |  4 +++
 .../es/{run_scripts.mdx => run_scripts.md}    |  4 +++
 .../source/es/{sagemaker.mdx => sagemaker.md} |  4 +++
 .../{serialization.mdx => serialization.md}   |  4 +++
 docs/source/es/tasks/{asr.mdx => asr.md}      |  4 +++
 ...sification.mdx => image_classification.md} |  4 +++
 ...uage_modeling.mdx => language_modeling.md} |  4 +++
 ...multiple_choice.mdx => multiple_choice.md} |  4 +++
 ...on_answering.mdx => question_answering.md} |  4 +++
 .../{summarization.mdx => summarization.md}   |  4 +++
 docs/source/es/{training.mdx => training.md}  |  4 +++
 docs/source/fr/in_translation.md              |  5 +++
 docs/source/fr/in_translation.mdx             |  1 -
 docs/source/fr/{index.mdx => index.md}        |  4 +++
 .../source/fr/{quicktour.mdx => quicktour.md} |  4 +++
 .../it/{accelerate.mdx => accelerate.md}      |  4 +++
 .../{add_new_model.mdx => add_new_model.md}   |  4 +++
 ...d_new_pipeline.mdx => add_new_pipeline.md} |  4 +++
 ...ass_tutorial.mdx => autoclass_tutorial.md} |  4 +++
 .../it/{big_models.mdx => big_models.md}      |  4 +++
 .../source/it/{community.mdx => community.md} |  6 +++-
 ...ls.mdx => converting_tensorflow_models.md} |  4 +++
 .../{create_a_model.mdx => create_a_model.md} |  4 +++
 .../{custom_models.mdx => custom_models.md}   |  4 +++
 .../source/it/{debugging.mdx => debugging.md} |  4 +++
 docs/source/it/{index.mdx => index.md}        |  4 +++
 .../it/{installation.mdx => installation.md}  |  4 +++
 .../source/it/{migration.mdx => migration.md} |  4 +++
 .../{model_sharing.mdx => model_sharing.md}   |  4 +++
 .../it/{multilingual.mdx => multilingual.md}  |  4 +++
 .../{perf_hardware.mdx => perf_hardware.md}   |  4 +++
 .../{perf_infer_cpu.mdx => perf_infer_cpu.md} |  4 +++
 ...er_gpu_many.mdx => perf_infer_gpu_many.md} |  4 +++
 ...nfer_gpu_one.mdx => perf_infer_gpu_one.md} |  4 +++
 ...nfer_special.mdx => perf_infer_special.md} |  4 +++
 .../{perf_train_cpu.mdx => perf_train_cpu.md} |  4 +++
 ...in_cpu_many.mdx => perf_train_cpu_many.md} |  4 +++
 ...rain_special.mdx => perf_train_special.md} |  4 +++
 .../{perf_train_tpu.mdx => perf_train_tpu.md} |  4 +++
 ...line_tutorial.mdx => pipeline_tutorial.md} |  4 +++
 .../source/it/{pr_checks.mdx => pr_checks.md} |  4 +++
 .../{preprocessing.mdx => preprocessing.md}   |  4 +++
 .../source/it/{quicktour.mdx => quicktour.md} |  4 +++
 .../it/{run_scripts.mdx => run_scripts.md}    |  4 +++
 .../{serialization.mdx => serialization.md}   |  4 +++
 docs/source/it/{training.mdx => training.md}  |  4 +++
 .../ja/{accelerate.mdx => accelerate.md}      |  4 +++
 docs/source/ja/{index.mdx => index.md}        |  4 +++
 .../ja/{installation.mdx => installation.md}  |  4 +++
 .../ja/{multilingual.mdx => multilingual.md}  |  4 +++
 .../ko/{accelerate.mdx => accelerate.md}      |  4 +++
 .../source/ko/{attention.mdx => attention.md} |  4 +++
 ...ass_tutorial.mdx => autoclass_tutorial.md} |  4 +++
 .../source/ko/{bertology.mdx => bertology.md} |  4 +++
 .../{create_a_model.mdx => create_a_model.md} |  4 +++
 .../{custom_models.mdx => custom_models.md}   |  4 +++
 ...fast_tokenizers.mdx => fast_tokenizers.md} |  4 +++
 docs/source/ko/in_translation.md              |  5 +++
 docs/source/ko/in_translation.mdx             |  1 -
 docs/source/ko/{index.mdx => index.md}        |  4 +++
 .../ko/{installation.mdx => installation.md}  |  4 +++
 .../{model_sharing.mdx => model_sharing.md}   |  4 +++
 .../ko/{multilingual.mdx => multilingual.md}  |  4 +++
 .../{pad_truncation.mdx => pad_truncation.md} |  4 +++
 ...line_tutorial.mdx => pipeline_tutorial.md} |  4 +++
 .../{preprocessing.mdx => preprocessing.md}   |  4 +++
 .../source/ko/{quicktour.mdx => quicktour.md} |  4 +++
 .../ko/{run_scripts.mdx => run_scripts.md}    |  4 +++
 .../source/ko/{sagemaker.mdx => sagemaker.md} |  4 +++
 .../{serialization.mdx => serialization.md}   |  4 +++
 .../ko/{task_summary.mdx => task_summary.md}  |  4 +++
 docs/source/ko/tasks/{asr.mdx => asr.md}      |  4 +++
 ...age_captioning.mdx => image_captioning.md} |  4 +++
 ...sification.mdx => image_classification.md} |  4 +++
 ...uage_modeling.mdx => language_modeling.md} |  4 +++
 ...deling.mdx => masked_language_modeling.md} |  4 +++
 ...tion.mdx => monocular_depth_estimation.md} |  4 +++
 ...multiple_choice.mdx => multiple_choice.md} |  4 +++
 ...ject_detection.mdx => object_detection.md} |  4 +++
 ...on_answering.mdx => question_answering.md} |  4 +++
 ...ication.mdx => sequence_classification.md} |  4 +++
 .../{summarization.mdx => summarization.md}   |  4 +++
 ...sification.mdx => token_classification.md} |  4 +++
 .../tasks/{translation.mdx => translation.md} |  4 +++
 ...sification.mdx => video_classification.md} |  4 +++
 ....mdx => zero_shot_image_classification.md} |  4 +++
 ...tion.mdx => zero_shot_object_detection.md} |  4 +++
 ...tasks_explained.mdx => tasks_explained.md} |  4 +++
 .../ko/{torchscript.mdx => torchscript.md}    |  4 +++
 docs/source/ko/{training.mdx => training.md}  |  4 +++
 ...troubleshooting.mdx => troubleshooting.md} |  4 +++
 docs/source/ms/{index.mdx => index.md}        |  4 +++
 .../pt/{accelerate.mdx => accelerate.md}      |  4 +++
 ...ls.mdx => converting_tensorflow_models.md} |  4 +++
 .../{create_a_model.mdx => create_a_model.md} |  4 +++
 .../{custom_models.mdx => custom_models.md}   |  4 +++
 ...fast_tokenizers.mdx => fast_tokenizers.md} |  4 +++
 docs/source/pt/{index.mdx => index.md}        |  4 +++
 .../pt/{installation.mdx => installation.md}  |  4 +++
 .../pt/{multilingual.mdx => multilingual.md}  |  4 +++
 ...line_tutorial.mdx => pipeline_tutorial.md} |  6 +++-
 .../source/pt/{quicktour.mdx => quicktour.md} |  4 +++
 .../pt/{run_scripts.mdx => run_scripts.md}    |  4 +++
 .../{serialization.mdx => serialization.md}   |  4 +++
 ...ication.mdx => sequence_classification.md} |  4 +++
 ...sification.mdx => token_classification.md} |  4 +++
 docs/source/pt/{training.mdx => training.md}  |  4 +++
 docs/source/zh/{index.mdx => index.md}        |  4 +++
 .../source/zh/{quicktour.mdx => quicktour.md} |  4 +++
 setup.cfg                                     |  2 +-
 src/transformers/commands/add_new_model.py    |  4 +--
 .../commands/add_new_model_like.py            |  8 ++---
 src/transformers/testing_utils.py             |  4 +--
 templates/adding_a_new_model/README.md        |  4 +--
 tests/utils/test_add_new_model_like.py        | 30 ++++++++--------
 utils/check_copies.py                         |  6 ++--
 utils/check_repo.py                           |  4 +--
 utils/check_table.py                          |  6 ++--
 utils/check_task_guides.py                    | 36 +++++++++----------
 utils/documentation_tests.txt                 | 28 +++++++--------
 utils/notification_service_doc_tests.py       |  2 +-
 utils/tests_fetcher.py                        |  6 ++--
 472 files changed, 1909 insertions(+), 98 deletions(-)
 rename docs/source/de/{accelerate.mdx => accelerate.md} (96%)
 rename docs/source/de/{autoclass_tutorial.mdx => autoclass_tutorial.md} (97%)
 rename docs/source/de/{index.mdx => index.md} (99%)
 rename docs/source/de/{installation.mdx => installation.md} (98%)
 rename docs/source/de/{model_sharing.mdx => model_sharing.md} (98%)
 rename docs/source/de/{pipeline_tutorial.mdx => pipeline_tutorial.md} (97%)
 rename docs/source/de/{preprocessing.mdx => preprocessing.md} (99%)
 rename docs/source/de/{quicktour.mdx => quicktour.md} (99%)
 rename docs/source/de/{training.mdx => training.md} (99%)
 rename docs/source/en/{accelerate.mdx => accelerate.md} (96%)
 rename docs/source/en/{add_new_model.mdx => add_new_model.md} (99%)
 rename docs/source/en/{add_new_pipeline.mdx => add_new_pipeline.md} (98%)
 rename docs/source/en/{add_tensorflow_model.mdx => add_tensorflow_model.md} (98%)
 rename docs/source/en/{attention.mdx => attention.md} (95%)
 rename docs/source/en/{autoclass_tutorial.mdx => autoclass_tutorial.md} (97%)
 rename docs/source/en/{benchmarks.mdx => benchmarks.md} (99%)
 rename docs/source/en/{bertology.mdx => bertology.md} (92%)
 rename docs/source/en/{big_models.mdx => big_models.md} (97%)
 rename docs/source/en/{community.mdx => community.md} (99%)
 rename docs/source/en/{create_a_model.mdx => create_a_model.md} (98%)
 rename docs/source/en/{custom_models.mdx => custom_models.md} (98%)
 rename docs/source/en/{custom_tools.mdx => custom_tools.md} (99%)
 rename docs/source/en/{debugging.mdx => debugging.md} (98%)
 rename docs/source/en/{fast_tokenizers.mdx => fast_tokenizers.md} (94%)
 rename docs/source/en/{generation_strategies.mdx => generation_strategies.md} (98%)
 rename docs/source/en/{glossary.mdx => glossary.md} (99%)
 rename docs/source/en/{hpo_train.mdx => hpo_train.md} (96%)
 rename docs/source/en/{index.mdx => index.md} (99%)
 rename docs/source/en/{installation.mdx => installation.md} (98%)
 rename docs/source/en/internal/{audio_utils.mdx => audio_utils.md} (88%)
 rename docs/source/en/internal/{file_utils.mdx => file_utils.md} (88%)
 rename docs/source/en/internal/{generation_utils.mdx => generation_utils.md} (97%)
 rename docs/source/en/internal/{image_processing_utils.mdx => image_processing_utils.md} (89%)
 rename docs/source/en/internal/{modeling_utils.mdx => modeling_utils.md} (92%)
 rename docs/source/en/internal/{pipelines_utils.mdx => pipelines_utils.md} (87%)
 rename docs/source/en/internal/{time_series_utils.mdx => time_series_utils.md} (86%)
 rename docs/source/en/internal/{tokenization_utils.mdx => tokenization_utils.md} (89%)
 rename docs/source/en/internal/{trainer_utils.mdx => trainer_utils.md} (87%)
 rename docs/source/en/main_classes/{agent.mdx => agent.md} (94%)
 rename docs/source/en/main_classes/{callback.mdx => callback.md} (96%)
 rename docs/source/en/main_classes/{configuration.mdx => configuration.md} (87%)
 rename docs/source/en/main_classes/{data_collator.mdx => data_collator.md} (92%)
 rename docs/source/en/main_classes/{deepspeed.mdx => deepspeed.md} (99%)
 rename docs/source/en/main_classes/{feature_extractor.mdx => feature_extractor.md} (88%)
 rename docs/source/en/main_classes/{image_processor.mdx => image_processor.md} (87%)
 rename docs/source/en/main_classes/{keras_callbacks.mdx => keras_callbacks.md} (83%)
 rename docs/source/en/main_classes/{logging.mdx => logging.md} (95%)
 rename docs/source/en/main_classes/{model.mdx => model.md} (97%)
 rename docs/source/en/main_classes/{onnx.mdx => onnx.md} (90%)
 rename docs/source/en/main_classes/{optimizer_schedules.mdx => optimizer_schedules.md} (92%)
 rename docs/source/en/main_classes/{output.mdx => output.md} (98%)
 rename docs/source/en/main_classes/{pipelines.mdx => pipelines.md} (98%)
 rename docs/source/en/main_classes/{processors.mdx => processors.md} (97%)
 rename docs/source/en/main_classes/{quantization.mdx => quantization.md} (98%)
 rename docs/source/en/main_classes/{text_generation.mdx => text_generation.md} (92%)
 rename docs/source/en/main_classes/{tokenizer.mdx => tokenizer.md} (95%)
 rename docs/source/en/main_classes/{trainer.mdx => trainer.md} (99%)
 rename docs/source/en/model_doc/{albert.mdx => albert.md} (97%)
 rename docs/source/en/model_doc/{align.mdx => align.md} (97%)
 rename docs/source/en/model_doc/{altclip.mdx => altclip.md} (96%)
 rename docs/source/en/model_doc/{audio-spectrogram-transformer.mdx => audio-spectrogram-transformer.md} (96%)
 rename docs/source/en/model_doc/{auto.mdx => auto.md} (97%)
 rename docs/source/en/model_doc/{autoformer.mdx => autoformer.md} (94%)
 rename docs/source/en/model_doc/{bart.mdx => bart.md} (98%)
 rename docs/source/en/model_doc/{barthez.mdx => barthez.md} (94%)
 rename docs/source/en/model_doc/{bartpho.mdx => bartpho.md} (95%)
 rename docs/source/en/model_doc/{beit.mdx => beit.md} (97%)
 rename docs/source/en/model_doc/{bert-generation.mdx => bert-generation.md} (96%)
 rename docs/source/en/model_doc/{bert-japanese.mdx => bert-japanese.md} (93%)
 rename docs/source/en/model_doc/{bert.mdx => bert.md} (98%)
 rename docs/source/en/model_doc/{bertweet.mdx => bertweet.md} (93%)
 rename docs/source/en/model_doc/{big_bird.mdx => big_bird.md} (97%)
 rename docs/source/en/model_doc/{bigbird_pegasus.mdx => bigbird_pegasus.md} (96%)
 rename docs/source/en/model_doc/{biogpt.mdx => biogpt.md} (95%)
 rename docs/source/en/model_doc/{bit.mdx => bit.md} (95%)
 rename docs/source/en/model_doc/{blenderbot-small.mdx => blenderbot-small.md} (95%)
 rename docs/source/en/model_doc/{blenderbot.mdx => blenderbot.md} (96%)
 rename docs/source/en/model_doc/{blip-2.mdx => blip-2.md} (96%)
 rename docs/source/en/model_doc/{blip.mdx => blip.md} (95%)
 rename docs/source/en/model_doc/{bloom.mdx => bloom.md} (95%)
 rename docs/source/en/model_doc/{bort.mdx => bort.md} (94%)
 rename docs/source/en/model_doc/{bridgetower.mdx => bridgetower.md} (97%)
 rename docs/source/en/model_doc/{byt5.mdx => byt5.md} (97%)
 rename docs/source/en/model_doc/{camembert.mdx => camembert.md} (95%)
 rename docs/source/en/model_doc/{canine.mdx => canine.md} (97%)
 rename docs/source/en/model_doc/{chinese_clip.mdx => chinese_clip.md} (96%)
 rename docs/source/en/model_doc/{clap.mdx => clap.md} (95%)
 rename docs/source/en/model_doc/{clip.mdx => clip.md} (97%)
 rename docs/source/en/model_doc/{clipseg.mdx => clipseg.md} (96%)
 rename docs/source/en/model_doc/{codegen.mdx => codegen.md} (96%)
 rename docs/source/en/model_doc/{conditional_detr.mdx => conditional_detr.md} (95%)
 rename docs/source/en/model_doc/{convbert.mdx => convbert.md} (96%)
 rename docs/source/en/model_doc/{convnext.mdx => convnext.md} (96%)
 rename docs/source/en/model_doc/{convnextv2.mdx => convnextv2.md} (95%)
 rename docs/source/en/model_doc/{cpm.mdx => cpm.md} (93%)
 rename docs/source/en/model_doc/{cpmant.mdx => cpmant.md} (90%)
 rename docs/source/en/model_doc/{ctrl.mdx => ctrl.md} (96%)
 rename docs/source/en/model_doc/{cvt.mdx => cvt.md} (96%)
 rename docs/source/en/model_doc/{data2vec.mdx => data2vec.md} (97%)
 rename docs/source/en/model_doc/{deberta-v2.mdx => deberta-v2.md} (97%)
 rename docs/source/en/model_doc/{deberta.mdx => deberta.md} (97%)
 rename docs/source/en/model_doc/{decision_transformer.mdx => decision_transformer.md} (93%)
 rename docs/source/en/model_doc/{deformable_detr.mdx => deformable_detr.md} (95%)
 rename docs/source/en/model_doc/{deit.mdx => deit.md} (97%)
 rename docs/source/en/model_doc/{deplot.mdx => deplot.md} (96%)
 rename docs/source/en/model_doc/{deta.mdx => deta.md} (95%)
 rename docs/source/en/model_doc/{detr.mdx => detr.md} (98%)
 rename docs/source/en/model_doc/{dialogpt.mdx => dialogpt.md} (94%)
 rename docs/source/en/model_doc/{dinat.mdx => dinat.md} (96%)
 rename docs/source/en/model_doc/{distilbert.mdx => distilbert.md} (98%)
 rename docs/source/en/model_doc/{dit.mdx => dit.md} (96%)
 rename docs/source/en/model_doc/{donut.mdx => donut.md} (98%)
 rename docs/source/en/model_doc/{dpr.mdx => dpr.md} (95%)
 rename docs/source/en/model_doc/{dpt.mdx => dpt.md} (95%)
 rename docs/source/en/model_doc/{efficientformer.mdx => efficientformer.md} (95%)
 rename docs/source/en/model_doc/{efficientnet.mdx => efficientnet.md} (94%)
 rename docs/source/en/model_doc/{electra.mdx => electra.md} (97%)
 rename docs/source/en/model_doc/{encodec.mdx => encodec.md} (95%)
 rename docs/source/en/model_doc/{encoder-decoder.mdx => encoder-decoder.md} (98%)
 rename docs/source/en/model_doc/{ernie.mdx => ernie.md} (95%)
 rename docs/source/en/model_doc/{ernie_m.mdx => ernie_m.md} (95%)
 rename docs/source/en/model_doc/{esm.mdx => esm.md} (97%)
 rename docs/source/en/model_doc/{flan-t5.mdx => flan-t5.md} (93%)
 rename docs/source/en/model_doc/{flan-ul2.mdx => flan-ul2.md} (94%)
 rename docs/source/en/model_doc/{flaubert.mdx => flaubert.md} (96%)
 rename docs/source/en/model_doc/{flava.mdx => flava.md} (94%)
 rename docs/source/en/model_doc/{fnet.mdx => fnet.md} (96%)
 rename docs/source/en/model_doc/{focalnet.mdx => focalnet.md} (95%)
 rename docs/source/en/model_doc/{fsmt.mdx => fsmt.md} (94%)
 rename docs/source/en/model_doc/{funnel.mdx => funnel.md} (97%)
 rename docs/source/en/model_doc/{git.mdx => git.md} (95%)
 rename docs/source/en/model_doc/{glpn.mdx => glpn.md} (95%)
 rename docs/source/en/model_doc/{gpt-sw3.mdx => gpt-sw3.md} (94%)
 rename docs/source/en/model_doc/{gpt2.mdx => gpt2.md} (97%)
 rename docs/source/en/model_doc/{gpt_bigcode.mdx => gpt_bigcode.md} (96%)
 rename docs/source/en/model_doc/{gpt_neo.mdx => gpt_neo.md} (94%)
 rename docs/source/en/model_doc/{gpt_neox.mdx => gpt_neox.md} (95%)
 rename docs/source/en/model_doc/{gpt_neox_japanese.mdx => gpt_neox_japanese.md} (94%)
 rename docs/source/en/model_doc/{gptj.mdx => gptj.md} (97%)
 rename docs/source/en/model_doc/{gptsan-japanese.mdx => gptsan-japanese.md} (96%)
 rename docs/source/en/model_doc/{graphormer.mdx => graphormer.md} (94%)
 rename docs/source/en/model_doc/{groupvit.mdx => groupvit.md} (95%)
 rename docs/source/en/model_doc/{herbert.mdx => herbert.md} (95%)
 rename docs/source/en/model_doc/{hubert.mdx => hubert.md} (94%)
 rename docs/source/en/model_doc/{ibert.mdx => ibert.md} (95%)
 rename docs/source/en/model_doc/{imagegpt.mdx => imagegpt.md} (97%)
 rename docs/source/en/model_doc/{informer.mdx => informer.md} (95%)
 rename docs/source/en/model_doc/{jukebox.mdx => jukebox.md} (96%)
 rename docs/source/en/model_doc/{layoutlm.mdx => layoutlm.md} (97%)
 rename docs/source/en/model_doc/{layoutlmv2.mdx => layoutlmv2.md} (99%)
 rename docs/source/en/model_doc/{layoutlmv3.mdx => layoutlmv3.md} (97%)
 rename docs/source/en/model_doc/{layoutxlm.mdx => layoutxlm.md} (95%)
 rename docs/source/en/model_doc/{led.mdx => led.md} (96%)
 rename docs/source/en/model_doc/{levit.mdx => levit.md} (97%)
 rename docs/source/en/model_doc/{lilt.mdx => lilt.md} (96%)
 rename docs/source/en/model_doc/{llama.mdx => llama.md} (96%)
 rename docs/source/en/model_doc/{longformer.mdx => longformer.md} (97%)
 rename docs/source/en/model_doc/{longt5.mdx => longt5.md} (97%)
 rename docs/source/en/model_doc/{luke.mdx => luke.md} (98%)
 rename docs/source/en/model_doc/{lxmert.mdx => lxmert.md} (96%)
 rename docs/source/en/model_doc/{m2m_100.mdx => m2m_100.md} (97%)
 rename docs/source/en/model_doc/{marian.mdx => marian.md} (98%)
 rename docs/source/en/model_doc/{markuplm.mdx => markuplm.md} (98%)
 rename docs/source/en/model_doc/{mask2former.mdx => mask2former.md} (96%)
 rename docs/source/en/model_doc/{maskformer.mdx => maskformer.md} (96%)
 rename docs/source/en/model_doc/{matcha.mdx => matcha.md} (96%)
 rename docs/source/en/model_doc/{mbart.mdx => mbart.md} (98%)
 rename docs/source/en/model_doc/{mctct.mdx => mctct.md} (94%)
 rename docs/source/en/model_doc/{mega.mdx => mega.md} (96%)
 rename docs/source/en/model_doc/{megatron-bert.mdx => megatron-bert.md} (97%)
 rename docs/source/en/model_doc/{megatron_gpt2.mdx => megatron_gpt2.md} (96%)
 rename docs/source/en/model_doc/{mgp-str.mdx => mgp-str.md} (96%)
 rename docs/source/en/model_doc/{mluke.mdx => mluke.md} (94%)
 rename docs/source/en/model_doc/{mms.mdx => mms.md} (98%)
 rename docs/source/en/model_doc/{mobilebert.mdx => mobilebert.md} (96%)
 rename docs/source/en/model_doc/{mobilenet_v1.mdx => mobilenet_v1.md} (96%)
 rename docs/source/en/model_doc/{mobilenet_v2.mdx => mobilenet_v2.md} (97%)
 rename docs/source/en/model_doc/{mobilevit.mdx => mobilevit.md} (97%)
 rename docs/source/en/model_doc/{mobilevitv2.mdx => mobilevitv2.md} (95%)
 rename docs/source/en/model_doc/{mpnet.mdx => mpnet.md} (96%)
 rename docs/source/en/model_doc/{mt5.mdx => mt5.md} (95%)
 rename docs/source/en/model_doc/{mvp.mdx => mvp.md} (97%)
 rename docs/source/en/model_doc/{nat.mdx => nat.md} (96%)
 rename docs/source/en/model_doc/{nezha.mdx => nezha.md} (94%)
 rename docs/source/en/model_doc/{nllb-moe.mdx => nllb-moe.md} (97%)
 rename docs/source/en/model_doc/{nllb.mdx => nllb.md} (97%)
 rename docs/source/en/model_doc/{nystromformer.mdx => nystromformer.md} (95%)
 rename docs/source/en/model_doc/{oneformer.mdx => oneformer.md} (97%)
 rename docs/source/en/model_doc/{open-llama.mdx => open-llama.md} (90%)
 rename docs/source/en/model_doc/{openai-gpt.mdx => openai-gpt.md} (97%)
 rename docs/source/en/model_doc/{opt.mdx => opt.md} (95%)
 rename docs/source/en/model_doc/{owlvit.mdx => owlvit.md} (97%)
 rename docs/source/en/model_doc/{pegasus.mdx => pegasus.md} (97%)
 rename docs/source/en/model_doc/{pegasus_x.mdx => pegasus_x.md} (94%)
 rename docs/source/en/model_doc/{perceiver.mdx => perceiver.md} (98%)
 rename docs/source/en/model_doc/{phobert.mdx => phobert.md} (92%)
 rename docs/source/en/model_doc/{pix2struct.mdx => pix2struct.md} (96%)
 rename docs/source/en/model_doc/{plbart.mdx => plbart.md} (97%)
 rename docs/source/en/model_doc/{poolformer.mdx => poolformer.md} (96%)
 rename docs/source/en/model_doc/{prophetnet.mdx => prophetnet.md} (96%)
 rename docs/source/en/model_doc/{qdqbert.mdx => qdqbert.md} (97%)
 rename docs/source/en/model_doc/{rag.mdx => rag.md} (96%)
 rename docs/source/en/model_doc/{realm.mdx => realm.md} (95%)
 rename docs/source/en/model_doc/{reformer.mdx => reformer.md} (98%)
 rename docs/source/en/model_doc/{regnet.mdx => regnet.md} (96%)
 rename docs/source/en/model_doc/{rembert.mdx => rembert.md} (96%)
 rename docs/source/en/model_doc/{resnet.mdx => resnet.md} (96%)
 rename docs/source/en/model_doc/{retribert.mdx => retribert.md} (89%)
 rename docs/source/en/model_doc/{roberta-prelayernorm.mdx => roberta-prelayernorm.md} (96%)
 rename docs/source/en/model_doc/{roberta.mdx => roberta.md} (98%)
 rename docs/source/en/model_doc/{roc_bert.mdx => roc_bert.md} (95%)
 rename docs/source/en/model_doc/{roformer.mdx => roformer.md} (96%)
 rename docs/source/en/model_doc/{rwkv.mdx => rwkv.md} (97%)
 rename docs/source/en/model_doc/{sam.mdx => sam.md} (96%)
 rename docs/source/en/model_doc/{segformer.mdx => segformer.md} (98%)
 rename docs/source/en/model_doc/{sew-d.mdx => sew-d.md} (93%)
 rename docs/source/en/model_doc/{sew.mdx => sew.md} (93%)
 rename docs/source/en/model_doc/{speech-encoder-decoder.mdx => speech-encoder-decoder.md} (97%)
 rename docs/source/en/model_doc/{speech_to_text.mdx => speech_to_text.md} (97%)
 rename docs/source/en/model_doc/{speech_to_text_2.mdx => speech_to_text_2.md} (96%)
 rename docs/source/en/model_doc/{speecht5.mdx => speecht5.md} (95%)
 rename docs/source/en/model_doc/{splinter.mdx => splinter.md} (96%)
 rename docs/source/en/model_doc/{squeezebert.mdx => squeezebert.md} (96%)
 rename docs/source/en/model_doc/{swiftformer.mdx => swiftformer.md} (95%)
 rename docs/source/en/model_doc/{swin.mdx => swin.md} (96%)
 rename docs/source/en/model_doc/{swin2sr.mdx => swin2sr.md} (95%)
 rename docs/source/en/model_doc/{swinv2.mdx => swinv2.md} (95%)
 rename docs/source/en/model_doc/{switch_transformers.mdx => switch_transformers.md} (96%)
 rename docs/source/en/model_doc/{t5.mdx => t5.md} (99%)
 rename docs/source/en/model_doc/{t5v1.1.mdx => t5v1.1.md} (94%)
 rename docs/source/en/model_doc/{table-transformer.mdx => table-transformer.md} (96%)
 rename docs/source/en/model_doc/{tapas.mdx => tapas.md} (99%)
 rename docs/source/en/model_doc/{tapex.mdx => tapex.md} (97%)
 rename docs/source/en/model_doc/{time_series_transformer.mdx => time_series_transformer.md} (96%)
 rename docs/source/en/model_doc/{timesformer.mdx => timesformer.md} (94%)
 rename docs/source/en/model_doc/{trajectory_transformer.mdx => trajectory_transformer.md} (94%)
 rename docs/source/en/model_doc/{transfo-xl.mdx => transfo-xl.md} (97%)
 rename docs/source/en/model_doc/{trocr.mdx => trocr.md} (97%)
 rename docs/source/en/model_doc/{tvlt.mdx => tvlt.md} (96%)
 rename docs/source/en/model_doc/{ul2.mdx => ul2.md} (94%)
 rename docs/source/en/model_doc/{unispeech-sat.mdx => unispeech-sat.md} (95%)
 rename docs/source/en/model_doc/{unispeech.mdx => unispeech.md} (94%)
 rename docs/source/en/model_doc/{upernet.mdx => upernet.md} (96%)
 rename docs/source/en/model_doc/{van.mdx => van.md} (95%)
 rename docs/source/en/model_doc/{videomae.mdx => videomae.md} (96%)
 rename docs/source/en/model_doc/{vilt.mdx => vilt.md} (96%)
 rename docs/source/en/model_doc/{vision-encoder-decoder.mdx => vision-encoder-decoder.md} (98%)
 rename docs/source/en/model_doc/{vision-text-dual-encoder.mdx => vision-text-dual-encoder.md} (92%)
 rename docs/source/en/model_doc/{visual_bert.mdx => visual_bert.md} (97%)
 rename docs/source/en/model_doc/{vit.mdx => vit.md} (98%)
 rename docs/source/en/model_doc/{vit_hybrid.mdx => vit_hybrid.md} (95%)
 rename docs/source/en/model_doc/{vit_mae.mdx => vit_mae.md} (96%)
 rename docs/source/en/model_doc/{vit_msn.mdx => vit_msn.md} (96%)
 rename docs/source/en/model_doc/{wav2vec2-conformer.mdx => wav2vec2-conformer.md} (94%)
 rename docs/source/en/model_doc/{wav2vec2.mdx => wav2vec2.md} (98%)
 rename docs/source/en/model_doc/{wav2vec2_phoneme.mdx => wav2vec2_phoneme.md} (94%)
 rename docs/source/en/model_doc/{wavlm.mdx => wavlm.md} (95%)
 rename docs/source/en/model_doc/{whisper.mdx => whisper.md} (95%)
 rename docs/source/en/model_doc/{xclip.mdx => xclip.md} (96%)
 rename docs/source/en/model_doc/{xglm.mdx => xglm.md} (95%)
 rename docs/source/en/model_doc/{xlm-prophetnet.mdx => xlm-prophetnet.md} (95%)
 rename docs/source/en/model_doc/{xlm-roberta-xl.mdx => xlm-roberta-xl.md} (95%)
 rename docs/source/en/model_doc/{xlm-roberta.mdx => xlm-roberta.md} (98%)
 rename docs/source/en/model_doc/{xlm-v.mdx => xlm-v.md} (94%)
 rename docs/source/en/model_doc/{xlm.mdx => xlm.md} (97%)
 rename docs/source/en/model_doc/{xlnet.mdx => xlnet.md} (97%)
 rename docs/source/en/model_doc/{xls_r.mdx => xls_r.md} (94%)
 rename docs/source/en/model_doc/{xlsr_wav2vec2.mdx => xlsr_wav2vec2.md} (93%)
 rename docs/source/en/model_doc/{xmod.mdx => xmod.md} (96%)
 rename docs/source/en/model_doc/{yolos.mdx => yolos.md} (95%)
 rename docs/source/en/model_doc/{yoso.mdx => yoso.md} (96%)
 rename docs/source/en/{model_sharing.mdx => model_sharing.md} (98%)
 rename docs/source/en/{model_summary.mdx => model_summary.md} (99%)
 rename docs/source/en/{multilingual.mdx => multilingual.md} (97%)
 rename docs/source/en/{pad_truncation.mdx => pad_truncation.md} (97%)
 rename docs/source/en/{perf_hardware.mdx => perf_hardware.md} (97%)
 rename docs/source/en/{perf_infer_cpu.mdx => perf_infer_cpu.md} (96%)
 rename docs/source/en/{perf_infer_gpu_many.mdx => perf_infer_gpu_many.md} (87%)
 rename docs/source/en/{perf_infer_gpu_one.mdx => perf_infer_gpu_one.md} (98%)
 rename docs/source/en/{perf_infer_special.mdx => perf_infer_special.md} (81%)
 rename docs/source/en/{perf_train_cpu.mdx => perf_train_cpu.md} (95%)
 rename docs/source/en/{perf_train_cpu_many.mdx => perf_train_cpu_many.md} (97%)
 rename docs/source/en/{perf_train_gpu_many.mdx => perf_train_gpu_many.md} (99%)
 rename docs/source/en/{perf_train_gpu_one.mdx => perf_train_gpu_one.md} (99%)
 rename docs/source/en/{perf_train_special.mdx => perf_train_special.md} (85%)
 rename docs/source/en/{perf_train_tpu.mdx => perf_train_tpu.md} (84%)
 rename docs/source/en/{perf_train_tpu_tf.mdx => perf_train_tpu_tf.md} (98%)
 rename docs/source/en/{performance.mdx => performance.md} (96%)
 rename docs/source/en/{perplexity.mdx => perplexity.md} (97%)
 rename docs/source/en/{philosophy.mdx => philosophy.md} (97%)
 rename docs/source/en/{pipeline_tutorial.mdx => pipeline_tutorial.md} (98%)
 rename docs/source/en/{pipeline_webserver.mdx => pipeline_webserver.md} (97%)
 rename docs/source/en/{pr_checks.mdx => pr_checks.md} (97%)
 rename docs/source/en/{preprocessing.mdx => preprocessing.md} (99%)
 rename docs/source/en/{quicktour.mdx => quicktour.md} (99%)
 rename docs/source/en/{run_scripts.mdx => run_scripts.md} (98%)
 rename docs/source/en/{sagemaker.mdx => sagemaker.md} (87%)
 rename docs/source/en/{serialization.mdx => serialization.md} (98%)
 rename docs/source/en/{task_summary.mdx => task_summary.md} (99%)
 rename docs/source/en/tasks/{asr.mdx => asr.md} (98%)
 rename docs/source/en/tasks/{audio_classification.mdx => audio_classification.md} (98%)
 rename docs/source/en/tasks/{document_question_answering.mdx => document_question_answering.md} (99%)
 rename docs/source/en/tasks/{image_captioning.mdx => image_captioning.md} (97%)
 rename docs/source/en/tasks/{image_classification.mdx => image_classification.md} (99%)
 rename docs/source/en/tasks/{language_modeling.mdx => language_modeling.md} (99%)
 rename docs/source/en/tasks/{masked_language_modeling.mdx => masked_language_modeling.md} (99%)
 rename docs/source/en/tasks/{monocular_depth_estimation.mdx => monocular_depth_estimation.md} (96%)
 rename docs/source/en/tasks/{multiple_choice.mdx => multiple_choice.md} (99%)
 rename docs/source/en/tasks/{object_detection.mdx => object_detection.md} (99%)
 rename docs/source/en/tasks/{question_answering.mdx => question_answering.md} (99%)
 rename docs/source/en/tasks/{semantic_segmentation.mdx => semantic_segmentation.md} (99%)
 rename docs/source/en/tasks/{sequence_classification.mdx => sequence_classification.md} (99%)
 rename docs/source/en/tasks/{summarization.mdx => summarization.md} (99%)
 rename docs/source/en/tasks/{text-to-speech.mdx => text-to-speech.md} (99%)
 rename docs/source/en/tasks/{token_classification.mdx => token_classification.md} (99%)
 rename docs/source/en/tasks/{translation.mdx => translation.md} (98%)
 rename docs/source/en/tasks/{video_classification.mdx => video_classification.md} (99%)
 rename docs/source/en/tasks/{zero_shot_image_classification.mdx => zero_shot_image_classification.md} (97%)
 rename docs/source/en/tasks/{zero_shot_object_detection.mdx => zero_shot_object_detection.md} (98%)
 rename docs/source/en/{tasks_explained.mdx => tasks_explained.md} (99%)
 rename docs/source/en/{testing.mdx => testing.md} (99%)
 rename docs/source/en/{tf_xla.mdx => tf_xla.md} (98%)
 rename docs/source/en/{tflite.mdx => tflite.md} (94%)
 rename docs/source/en/{tokenizer_summary.mdx => tokenizer_summary.md} (99%)
 rename docs/source/en/{torchscript.mdx => torchscript.md} (98%)
 rename docs/source/en/{training.mdx => training.md} (99%)
 rename docs/source/en/{transformers_agents.mdx => transformers_agents.md} (98%)
 rename docs/source/en/{troubleshooting.mdx => troubleshooting.md} (98%)
 rename docs/source/es/{accelerate.mdx => accelerate.md} (96%)
 rename docs/source/es/{add_new_pipeline.mdx => add_new_pipeline.md} (98%)
 rename docs/source/es/{autoclass_tutorial.mdx => autoclass_tutorial.md} (97%)
 rename docs/source/es/{bertology.mdx => bertology.md} (93%)
 rename docs/source/es/{community.mdx => community.md} (99%)
 rename docs/source/es/{converting_tensorflow_models.mdx => converting_tensorflow_models.md} (97%)
 rename docs/source/es/{create_a_model.mdx => create_a_model.md} (99%)
 rename docs/source/es/{custom_models.mdx => custom_models.md} (98%)
 rename docs/source/es/{debugging.mdx => debugging.md} (98%)
 rename docs/source/es/{fast_tokenizers.mdx => fast_tokenizers.md} (94%)
 rename docs/source/es/{index.mdx => index.md} (99%)
 rename docs/source/es/{installation.mdx => installation.md} (98%)
 rename docs/source/es/{model_sharing.mdx => model_sharing.md} (98%)
 rename docs/source/es/{multilingual.mdx => multilingual.md} (98%)
 rename docs/source/es/{philosophy.mdx => philosophy.md} (97%)
 rename docs/source/es/{pipeline_tutorial.mdx => pipeline_tutorial.md} (97%)
 rename docs/source/es/{pr_checks.mdx => pr_checks.md} (97%)
 rename docs/source/es/{preprocessing.mdx => preprocessing.md} (99%)
 rename docs/source/es/{quicktour.mdx => quicktour.md} (99%)
 rename docs/source/es/{run_scripts.mdx => run_scripts.md} (99%)
 rename docs/source/es/{sagemaker.mdx => sagemaker.md} (87%)
 rename docs/source/es/{serialization.mdx => serialization.md} (99%)
 rename docs/source/es/tasks/{asr.mdx => asr.md} (98%)
 rename docs/source/es/tasks/{image_classification.mdx => image_classification.md} (97%)
 rename docs/source/es/tasks/{language_modeling.mdx => language_modeling.md} (99%)
 rename docs/source/es/tasks/{multiple_choice.mdx => multiple_choice.md} (98%)
 rename docs/source/es/tasks/{question_answering.mdx => question_answering.md} (98%)
 rename docs/source/es/tasks/{summarization.mdx => summarization.md} (98%)
 rename docs/source/es/{training.mdx => training.md} (98%)
 create mode 100644 docs/source/fr/in_translation.md
 delete mode 100644 docs/source/fr/in_translation.mdx
 rename docs/source/fr/{index.mdx => index.md} (99%)
 rename docs/source/fr/{quicktour.mdx => quicktour.md} (99%)
 rename docs/source/it/{accelerate.mdx => accelerate.md} (96%)
 rename docs/source/it/{add_new_model.mdx => add_new_model.md} (99%)
 rename docs/source/it/{add_new_pipeline.mdx => add_new_pipeline.md} (98%)
 rename docs/source/it/{autoclass_tutorial.mdx => autoclass_tutorial.md} (97%)
 rename docs/source/it/{big_models.mdx => big_models.md} (97%)
 rename docs/source/it/{community.mdx => community.md} (99%)
 rename docs/source/it/{converting_tensorflow_models.mdx => converting_tensorflow_models.md} (97%)
 rename docs/source/it/{create_a_model.mdx => create_a_model.md} (98%)
 rename docs/source/it/{custom_models.mdx => custom_models.md} (98%)
 rename docs/source/it/{debugging.mdx => debugging.md} (98%)
 rename docs/source/it/{index.mdx => index.md} (99%)
 rename docs/source/it/{installation.mdx => installation.md} (98%)
 rename docs/source/it/{migration.mdx => migration.md} (98%)
 rename docs/source/it/{model_sharing.mdx => model_sharing.md} (98%)
 rename docs/source/it/{multilingual.mdx => multilingual.md} (98%)
 rename docs/source/it/{perf_hardware.mdx => perf_hardware.md} (97%)
 rename docs/source/it/{perf_infer_cpu.mdx => perf_infer_cpu.md} (96%)
 rename docs/source/it/{perf_infer_gpu_many.mdx => perf_infer_gpu_many.md} (88%)
 rename docs/source/it/{perf_infer_gpu_one.mdx => perf_infer_gpu_one.md} (97%)
 rename docs/source/it/{perf_infer_special.mdx => perf_infer_special.md} (81%)
 rename docs/source/it/{perf_train_cpu.mdx => perf_train_cpu.md} (95%)
 rename docs/source/it/{perf_train_cpu_many.mdx => perf_train_cpu_many.md} (97%)
 rename docs/source/it/{perf_train_special.mdx => perf_train_special.md} (86%)
 rename docs/source/it/{perf_train_tpu.mdx => perf_train_tpu.md} (85%)
 rename docs/source/it/{pipeline_tutorial.mdx => pipeline_tutorial.md} (97%)
 rename docs/source/it/{pr_checks.mdx => pr_checks.md} (97%)
 rename docs/source/it/{preprocessing.mdx => preprocessing.md} (99%)
 rename docs/source/it/{quicktour.mdx => quicktour.md} (99%)
 rename docs/source/it/{run_scripts.mdx => run_scripts.md} (99%)
 rename docs/source/it/{serialization.mdx => serialization.md} (99%)
 rename docs/source/it/{training.mdx => training.md} (98%)
 rename docs/source/ja/{accelerate.mdx => accelerate.md} (96%)
 rename docs/source/ja/{index.mdx => index.md} (99%)
 rename docs/source/ja/{installation.mdx => installation.md} (98%)
 rename docs/source/ja/{multilingual.mdx => multilingual.md} (98%)
 rename docs/source/ko/{accelerate.mdx => accelerate.md} (96%)
 rename docs/source/ko/{attention.mdx => attention.md} (96%)
 rename docs/source/ko/{autoclass_tutorial.mdx => autoclass_tutorial.md} (97%)
 rename docs/source/ko/{bertology.mdx => bertology.md} (93%)
 rename docs/source/ko/{create_a_model.mdx => create_a_model.md} (99%)
 rename docs/source/ko/{custom_models.mdx => custom_models.md} (99%)
 rename docs/source/ko/{fast_tokenizers.mdx => fast_tokenizers.md} (95%)
 create mode 100644 docs/source/ko/in_translation.md
 delete mode 100644 docs/source/ko/in_translation.mdx
 rename docs/source/ko/{index.mdx => index.md} (99%)
 rename docs/source/ko/{installation.mdx => installation.md} (98%)
 rename docs/source/ko/{model_sharing.mdx => model_sharing.md} (98%)
 rename docs/source/ko/{multilingual.mdx => multilingual.md} (98%)
 rename docs/source/ko/{pad_truncation.mdx => pad_truncation.md} (97%)
 rename docs/source/ko/{pipeline_tutorial.mdx => pipeline_tutorial.md} (98%)
 rename docs/source/ko/{preprocessing.mdx => preprocessing.md} (99%)
 rename docs/source/ko/{quicktour.mdx => quicktour.md} (99%)
 rename docs/source/ko/{run_scripts.mdx => run_scripts.md} (99%)
 rename docs/source/ko/{sagemaker.mdx => sagemaker.md} (87%)
 rename docs/source/ko/{serialization.mdx => serialization.md} (99%)
 rename docs/source/ko/{task_summary.mdx => task_summary.md} (99%)
 rename docs/source/ko/tasks/{asr.mdx => asr.md} (98%)
 rename docs/source/ko/tasks/{image_captioning.mdx => image_captioning.md} (98%)
 rename docs/source/ko/tasks/{image_classification.mdx => image_classification.md} (99%)
 rename docs/source/ko/tasks/{language_modeling.mdx => language_modeling.md} (99%)
 rename docs/source/ko/tasks/{masked_language_modeling.mdx => masked_language_modeling.md} (99%)
 rename docs/source/ko/tasks/{monocular_depth_estimation.mdx => monocular_depth_estimation.md} (97%)
 rename docs/source/ko/tasks/{multiple_choice.mdx => multiple_choice.md} (99%)
 rename docs/source/ko/tasks/{object_detection.mdx => object_detection.md} (99%)
 rename docs/source/ko/tasks/{question_answering.mdx => question_answering.md} (99%)
 rename docs/source/ko/tasks/{sequence_classification.mdx => sequence_classification.md} (99%)
 rename docs/source/ko/tasks/{summarization.mdx => summarization.md} (99%)
 rename docs/source/ko/tasks/{token_classification.mdx => token_classification.md} (99%)
 rename docs/source/ko/tasks/{translation.mdx => translation.md} (99%)
 rename docs/source/ko/tasks/{video_classification.mdx => video_classification.md} (99%)
 rename docs/source/ko/tasks/{zero_shot_image_classification.mdx => zero_shot_image_classification.md} (97%)
 rename docs/source/ko/tasks/{zero_shot_object_detection.mdx => zero_shot_object_detection.md} (98%)
 rename docs/source/ko/{tasks_explained.mdx => tasks_explained.md} (99%)
 rename docs/source/ko/{torchscript.mdx => torchscript.md} (98%)
 rename docs/source/ko/{training.mdx => training.md} (99%)
 rename docs/source/ko/{troubleshooting.mdx => troubleshooting.md} (98%)
 rename docs/source/ms/{index.mdx => index.md} (99%)
 rename docs/source/pt/{accelerate.mdx => accelerate.md} (96%)
 rename docs/source/pt/{converting_tensorflow_models.mdx => converting_tensorflow_models.md} (97%)
 rename docs/source/pt/{create_a_model.mdx => create_a_model.md} (98%)
 rename docs/source/pt/{custom_models.mdx => custom_models.md} (98%)
 rename docs/source/pt/{fast_tokenizers.mdx => fast_tokenizers.md} (94%)
 rename docs/source/pt/{index.mdx => index.md} (99%)
 rename docs/source/pt/{installation.mdx => installation.md} (98%)
 rename docs/source/pt/{multilingual.mdx => multilingual.md} (98%)
 rename docs/source/pt/{pipeline_tutorial.mdx => pipeline_tutorial.md} (96%)
 rename docs/source/pt/{quicktour.mdx => quicktour.md} (99%)
 rename docs/source/pt/{run_scripts.mdx => run_scripts.md} (99%)
 rename docs/source/pt/{serialization.mdx => serialization.md} (99%)
 rename docs/source/pt/tasks/{sequence_classification.mdx => sequence_classification.md} (98%)
 rename docs/source/pt/tasks/{token_classification.mdx => token_classification.md} (98%)
 rename docs/source/pt/{training.mdx => training.md} (98%)
 rename docs/source/zh/{index.mdx => index.md} (99%)
 rename docs/source/zh/{quicktour.mdx => quicktour.md} (99%)

diff --git a/.circleci/create_circleci_config.py b/.circleci/create_circleci_config.py
index 21e5b055ff..ef0acdb665 100644
--- a/.circleci/create_circleci_config.py
+++ b/.circleci/create_circleci_config.py
@@ -480,7 +480,7 @@ doc_test_job = CircleCIJob(
         },
     ],
     tests_to_run="$(cat pr_documentation_tests.txt)",  # noqa
-    pytest_options={"-doctest-modules": None, "doctest-glob": "*.mdx", "dist": "loadfile", "rvsA": None},
+    pytest_options={"-doctest-modules": None, "doctest-glob": "*.md", "dist": "loadfile", "rvsA": None},
     command_timeout=1200,  # test cannot run longer than 1200 seconds
     pytest_num_workers=1,
 )
diff --git a/.github/ISSUE_TEMPLATE/i18n.md b/.github/ISSUE_TEMPLATE/i18n.md
index 39d369a253..3d0b6938ed 100644
--- a/.github/ISSUE_TEMPLATE/i18n.md
+++ b/.github/ISSUE_TEMPLATE/i18n.md
@@ -28,18 +28,18 @@ Some notes:
 
 ## Get Started section
 
-- [ ] [index.mdx](https://github.com/huggingface/transformers/blob/main/docs/source/en/index.mdx) https://github.com/huggingface/transformers/pull/20180
-- [ ] [quicktour.mdx](https://github.com/huggingface/transformers/blob/main/docs/source/en/quicktour.mdx) (waiting for initial PR to go through)
-- [ ] [installation.mdx](https://github.com/huggingface/transformers/blob/main/docs/source/en/installation.mdx).
+- [ ] [index.md](https://github.com/huggingface/transformers/blob/main/docs/source/en/index.md) https://github.com/huggingface/transformers/pull/20180
+- [ ] [quicktour.md](https://github.com/huggingface/transformers/blob/main/docs/source/en/quicktour.md) (waiting for initial PR to go through)
+- [ ] [installation.md](https://github.com/huggingface/transformers/blob/main/docs/source/en/installation.md).
 
 ## Tutorial section
-- [ ] [pipeline_tutorial.mdx](https://github.com/huggingface/transformers/blob/main/docs/source/en/pipeline_tutorial.mdx)
-- [ ]  [autoclass_tutorial.mdx](https://github.com/huggingface/transformers/blob/master/docs/source/autoclass_tutorial.mdx)
-- [ ]  [preprocessing.mdx](https://github.com/huggingface/transformers/blob/main/docs/source/en/preprocessing.mdx)
-- [ ]  [training.mdx](https://github.com/huggingface/transformers/blob/main/docs/source/en/training.mdx)
-- [ ]  [accelerate.mdx](https://github.com/huggingface/transformers/blob/main/docs/source/en/accelerate.mdx)
-- [ ]  [model_sharing.mdx](https://github.com/huggingface/transformers/blob/main/docs/source/en/model_sharing.mdx)
-- [ ]  [multilingual.mdx](https://github.com/huggingface/transformers/blob/main/docs/source/en/multilingual.mdx)
+- [ ] [pipeline_tutorial.md](https://github.com/huggingface/transformers/blob/main/docs/source/en/pipeline_tutorial.md)
+- [ ]  [autoclass_tutorial.md](https://github.com/huggingface/transformers/blob/master/docs/source/autoclass_tutorial.md)
+- [ ]  [preprocessing.md](https://github.com/huggingface/transformers/blob/main/docs/source/en/preprocessing.md)
+- [ ]  [training.md](https://github.com/huggingface/transformers/blob/main/docs/source/en/training.md)
+- [ ]  [accelerate.md](https://github.com/huggingface/transformers/blob/main/docs/source/en/accelerate.md)
+- [ ]  [model_sharing.md](https://github.com/huggingface/transformers/blob/main/docs/source/en/model_sharing.md)
+- [ ]  [multilingual.md](https://github.com/huggingface/transformers/blob/main/docs/source/en/multilingual.md)
 
 <!--
 Keep on adding more as you go 🔥
diff --git a/.github/workflows/doctests.yml b/.github/workflows/doctests.yml
index 76eeb001df..2dde2bd4d5 100644
--- a/.github/workflows/doctests.yml
+++ b/.github/workflows/doctests.yml
@@ -45,7 +45,7 @@ jobs:
 
       - name: Run doctests
         run: |
-          python3 -m pytest -v --make-reports doc_tests_gpu --doctest-modules $(cat utils/documentation_tests.txt) -sv --doctest-continue-on-failure --doctest-glob="*.mdx"
+          python3 -m pytest -v --make-reports doc_tests_gpu --doctest-modules $(cat utils/documentation_tests.txt) -sv --doctest-continue-on-failure --doctest-glob="*.md"
 
       - name: Failure short reports
         if: ${{ failure() }}
diff --git a/docs/README.md b/docs/README.md
index b4278cc0dc..bc6efe6efb 100644
--- a/docs/README.md
+++ b/docs/README.md
@@ -81,7 +81,7 @@ The `preview` command only works with existing doc files. When you add a complet
 
 ## Adding a new element to the navigation bar
 
-Accepted files are Markdown (.md or .mdx).
+Accepted files are Markdown (.md or .md).
 
 Create a file with its extension and put it in the source directory. You can then link it to the toc-tree by putting
 the filename without the extension in the [`_toctree.yml`](https://github.com/huggingface/transformers/blob/main/docs/source/_toctree.yml) file.
@@ -109,7 +109,7 @@ Sections that were moved:
 
 Use the relative style to link to the new file so that the versioned docs continue to work.
 
-For an example of a rich moved section set please see the very end of [the Trainer doc](https://github.com/huggingface/transformers/blob/main/docs/source/en/main_classes/trainer.mdx).
+For an example of a rich moved section set please see the very end of [the Trainer doc](https://github.com/huggingface/transformers/blob/main/docs/source/en/main_classes/trainer.md).
 
 
 ## Writing Documentation - Specification
@@ -138,7 +138,7 @@ When translating, refer to the guide at [./TRANSLATING.md](https://github.com/hu
 
 When adding a new model:
 
-- Create a file `xxx.mdx` or under `./source/model_doc` (don't hesitate to copy an existing file as template).
+- Create a file `xxx.md` or under `./source/model_doc` (don't hesitate to copy an existing file as template).
 - Link that file in `./source/_toctree.yml`.
 - Write a short overview of the model:
     - Overview with paper & authors
@@ -386,7 +386,7 @@ pytest --doctest-modules src/transformers/models/wav2vec2/modeling_wav2vec2.py::
 You can test locally a given file with this command (here testing the quicktour):
 
 ```bash
-pytest --doctest-modules docs/source/quicktour.mdx -sv --doctest-continue-on-failure --doctest-glob="*.mdx"
+pytest --doctest-modules docs/source/quicktour.md -sv --doctest-continue-on-failure --doctest-glob="*.md"
 ```
 
 ### Writing doctests
diff --git a/docs/source/de/accelerate.mdx b/docs/source/de/accelerate.md
similarity index 96%
rename from docs/source/de/accelerate.mdx
rename to docs/source/de/accelerate.md
index 64f85f205f..98a11cbdc4 100644
--- a/docs/source/de/accelerate.mdx
+++ b/docs/source/de/accelerate.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # Verteiltes Training mit 🤗 Accelerate
diff --git a/docs/source/de/autoclass_tutorial.mdx b/docs/source/de/autoclass_tutorial.md
similarity index 97%
rename from docs/source/de/autoclass_tutorial.mdx
rename to docs/source/de/autoclass_tutorial.md
index 95247cd04b..7707f7b39b 100644
--- a/docs/source/de/autoclass_tutorial.mdx
+++ b/docs/source/de/autoclass_tutorial.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # Vortrainierte Instanzen mit einer AutoClass laden
diff --git a/docs/source/de/index.mdx b/docs/source/de/index.md
similarity index 99%
rename from docs/source/de/index.mdx
rename to docs/source/de/index.md
index c14e803ed0..22f34aa847 100644
--- a/docs/source/de/index.mdx
+++ b/docs/source/de/index.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # 🤗 Transformers
diff --git a/docs/source/de/installation.mdx b/docs/source/de/installation.md
similarity index 98%
rename from docs/source/de/installation.mdx
rename to docs/source/de/installation.md
index 3103830ee7..295c9cad97 100644
--- a/docs/source/de/installation.mdx
+++ b/docs/source/de/installation.md
@@ -12,6 +12,10 @@ distributed under the License is distributed on an "AS IS" BASIS,
 WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 See the License for the specific language governing permissions and
 limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # Installation
diff --git a/docs/source/de/model_sharing.mdx b/docs/source/de/model_sharing.md
similarity index 98%
rename from docs/source/de/model_sharing.mdx
rename to docs/source/de/model_sharing.md
index 42b09d40d7..415277e00e 100644
--- a/docs/source/de/model_sharing.mdx
+++ b/docs/source/de/model_sharing.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # Ein Modell teilen
diff --git a/docs/source/de/pipeline_tutorial.mdx b/docs/source/de/pipeline_tutorial.md
similarity index 97%
rename from docs/source/de/pipeline_tutorial.mdx
rename to docs/source/de/pipeline_tutorial.md
index 19c37c35de..06ab440d73 100644
--- a/docs/source/de/pipeline_tutorial.mdx
+++ b/docs/source/de/pipeline_tutorial.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # Pipelines für Inferenzen
diff --git a/docs/source/de/preprocessing.mdx b/docs/source/de/preprocessing.md
similarity index 99%
rename from docs/source/de/preprocessing.mdx
rename to docs/source/de/preprocessing.md
index ea6c185cc1..eb3b3057c3 100644
--- a/docs/source/de/preprocessing.mdx
+++ b/docs/source/de/preprocessing.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # Vorverarbeiten
diff --git a/docs/source/de/quicktour.mdx b/docs/source/de/quicktour.md
similarity index 99%
rename from docs/source/de/quicktour.mdx
rename to docs/source/de/quicktour.md
index 4c668bf419..7026b087bf 100644
--- a/docs/source/de/quicktour.mdx
+++ b/docs/source/de/quicktour.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # Schnellstart
diff --git a/docs/source/de/training.mdx b/docs/source/de/training.md
similarity index 99%
rename from docs/source/de/training.mdx
rename to docs/source/de/training.md
index e38779ba55..493de3052b 100644
--- a/docs/source/de/training.mdx
+++ b/docs/source/de/training.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # Optimierung eines vortrainierten Modells
diff --git a/docs/source/en/accelerate.mdx b/docs/source/en/accelerate.md
similarity index 96%
rename from docs/source/en/accelerate.mdx
rename to docs/source/en/accelerate.md
index 02e05df390..17be77d677 100644
--- a/docs/source/en/accelerate.mdx
+++ b/docs/source/en/accelerate.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # Distributed training with 🤗 Accelerate
diff --git a/docs/source/en/add_new_model.mdx b/docs/source/en/add_new_model.md
similarity index 99%
rename from docs/source/en/add_new_model.mdx
rename to docs/source/en/add_new_model.md
index 38efaa945d..b330535408 100644
--- a/docs/source/en/add_new_model.mdx
+++ b/docs/source/en/add_new_model.md
@@ -7,6 +7,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # How to add a model to 🤗 Transformers?
@@ -817,7 +821,7 @@ tests for you.
 
 Now, all the necessary functionality for *brand_new_bert* is added - you're almost done! The only thing left to add is
 a nice docstring and a doc page. The Cookiecutter should have added a template file called
-`docs/source/model_doc/brand_new_bert.mdx` that you should fill out. Users of your model will usually first look at
+`docs/source/model_doc/brand_new_bert.md` that you should fill out. Users of your model will usually first look at
 this page before using your model. Hence, the documentation must be understandable and concise. It is very useful for
 the community to add some *Tips* to show how the model should be used. Don't hesitate to ping the Hugging Face team
 regarding the docstrings.
diff --git a/docs/source/en/add_new_pipeline.mdx b/docs/source/en/add_new_pipeline.md
similarity index 98%
rename from docs/source/en/add_new_pipeline.mdx
rename to docs/source/en/add_new_pipeline.md
index b0cc2cd0ff..cb1518752b 100644
--- a/docs/source/en/add_new_pipeline.mdx
+++ b/docs/source/en/add_new_pipeline.md
@@ -7,6 +7,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # How to create a custom pipeline?
diff --git a/docs/source/en/add_tensorflow_model.mdx b/docs/source/en/add_tensorflow_model.md
similarity index 98%
rename from docs/source/en/add_tensorflow_model.mdx
rename to docs/source/en/add_tensorflow_model.md
index f59b318b3f..6efbdee1bf 100644
--- a/docs/source/en/add_tensorflow_model.mdx
+++ b/docs/source/en/add_tensorflow_model.md
@@ -7,6 +7,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # How to convert a 🤗 Transformers model to TensorFlow?
@@ -228,9 +232,9 @@ changes:
 - Include the modeling file in the documentation test file list in `utils/documentation_tests.txt`
 - Add the lazy loading classes related to *BrandNewBert* in `src/transformers/utils/dummy_tf_objects.py`
 - Update the import structures for the public classes in `src/transformers/models/brand_new_bert/__init__.py`
-- Add the documentation pointers to the public methods of *BrandNewBert* in `docs/source/en/model_doc/brand_new_bert.mdx`
-- Add yourself to the list of contributors to *BrandNewBert* in `docs/source/en/model_doc/brand_new_bert.mdx`
-- Finally, add a green tick ✅ to the TensorFlow column of *BrandNewBert* in `docs/source/en/index.mdx`
+- Add the documentation pointers to the public methods of *BrandNewBert* in `docs/source/en/model_doc/brand_new_bert.md`
+- Add yourself to the list of contributors to *BrandNewBert* in `docs/source/en/model_doc/brand_new_bert.md`
+- Finally, add a green tick ✅ to the TensorFlow column of *BrandNewBert* in `docs/source/en/index.md`
 
 When you're happy with your implementation, run the following checklist to confirm that your model architecture is
 ready:
diff --git a/docs/source/en/attention.mdx b/docs/source/en/attention.md
similarity index 95%
rename from docs/source/en/attention.mdx
rename to docs/source/en/attention.md
index d6542b3be4..3a4f93b33f 100644
--- a/docs/source/en/attention.mdx
+++ b/docs/source/en/attention.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # Attention mechanisms
diff --git a/docs/source/en/autoclass_tutorial.mdx b/docs/source/en/autoclass_tutorial.md
similarity index 97%
rename from docs/source/en/autoclass_tutorial.mdx
rename to docs/source/en/autoclass_tutorial.md
index 6b44e41a85..e26a5612db 100644
--- a/docs/source/en/autoclass_tutorial.mdx
+++ b/docs/source/en/autoclass_tutorial.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # Load pretrained instances with an AutoClass
diff --git a/docs/source/en/benchmarks.mdx b/docs/source/en/benchmarks.md
similarity index 99%
rename from docs/source/en/benchmarks.mdx
rename to docs/source/en/benchmarks.md
index 244112001f..5023d24869 100644
--- a/docs/source/en/benchmarks.mdx
+++ b/docs/source/en/benchmarks.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # Benchmarks
diff --git a/docs/source/en/bertology.mdx b/docs/source/en/bertology.md
similarity index 92%
rename from docs/source/en/bertology.mdx
rename to docs/source/en/bertology.md
index 505b569028..ba1b4bd400 100644
--- a/docs/source/en/bertology.mdx
+++ b/docs/source/en/bertology.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # BERTology
diff --git a/docs/source/en/big_models.mdx b/docs/source/en/big_models.md
similarity index 97%
rename from docs/source/en/big_models.mdx
rename to docs/source/en/big_models.md
index 971403b62d..4b35126f4d 100644
--- a/docs/source/en/big_models.mdx
+++ b/docs/source/en/big_models.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # Instantiating a big model
diff --git a/docs/source/en/community.mdx b/docs/source/en/community.md
similarity index 99%
rename from docs/source/en/community.mdx
rename to docs/source/en/community.md
index 05164ffdaa..74c577567a 100644
--- a/docs/source/en/community.mdx
+++ b/docs/source/en/community.md
@@ -1,4 +1,8 @@
-# Community
+<!--⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+-->
+
+# Community
 
 This page regroups resources around 🤗 Transformers developed by the community.
 
diff --git a/docs/source/en/create_a_model.mdx b/docs/source/en/create_a_model.md
similarity index 98%
rename from docs/source/en/create_a_model.mdx
rename to docs/source/en/create_a_model.md
index 5c736f1d79..239edf085c 100644
--- a/docs/source/en/create_a_model.mdx
+++ b/docs/source/en/create_a_model.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # Create a custom architecture
diff --git a/docs/source/en/custom_models.mdx b/docs/source/en/custom_models.md
similarity index 98%
rename from docs/source/en/custom_models.mdx
rename to docs/source/en/custom_models.md
index f5ad558562..5caedb32ef 100644
--- a/docs/source/en/custom_models.mdx
+++ b/docs/source/en/custom_models.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # Sharing custom models
diff --git a/docs/source/en/custom_tools.mdx b/docs/source/en/custom_tools.md
similarity index 99%
rename from docs/source/en/custom_tools.mdx
rename to docs/source/en/custom_tools.md
index feb4c7ac46..3d11c2473d 100644
--- a/docs/source/en/custom_tools.mdx
+++ b/docs/source/en/custom_tools.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # Custom Tools and Prompts
diff --git a/docs/source/en/debugging.mdx b/docs/source/en/debugging.md
similarity index 98%
rename from docs/source/en/debugging.mdx
rename to docs/source/en/debugging.md
index 92dfe639c1..b1a430e734 100644
--- a/docs/source/en/debugging.mdx
+++ b/docs/source/en/debugging.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # Debugging
diff --git a/docs/source/en/fast_tokenizers.mdx b/docs/source/en/fast_tokenizers.md
similarity index 94%
rename from docs/source/en/fast_tokenizers.mdx
rename to docs/source/en/fast_tokenizers.md
index 234f9bb42d..aebc171060 100644
--- a/docs/source/en/fast_tokenizers.mdx
+++ b/docs/source/en/fast_tokenizers.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # Use tokenizers from 🤗 Tokenizers
diff --git a/docs/source/en/generation_strategies.mdx b/docs/source/en/generation_strategies.md
similarity index 98%
rename from docs/source/en/generation_strategies.mdx
rename to docs/source/en/generation_strategies.md
index b59649bae4..5552fc0829 100644
--- a/docs/source/en/generation_strategies.mdx
+++ b/docs/source/en/generation_strategies.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # Text generation strategies
@@ -331,7 +335,7 @@ The groups are selected to ensure they are distinct enough compared to the other
 
 This guide illustrates the main parameters that enable various decoding strategies. More advanced parameters exist for the
 [`generate`] method, which gives you even further control over the [`generate`] method's behavior.
-For the complete list of the available parameters, refer to the [API documentation](./main_classes/text_generation.mdx).
+For the complete list of the available parameters, refer to the [API documentation](./main_classes/text_generation.md).
 
 ### Assisted Decoding
 
diff --git a/docs/source/en/glossary.mdx b/docs/source/en/glossary.md
similarity index 99%
rename from docs/source/en/glossary.mdx
rename to docs/source/en/glossary.md
index 6d47f64764..08d71ee18b 100644
--- a/docs/source/en/glossary.mdx
+++ b/docs/source/en/glossary.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # Glossary
diff --git a/docs/source/en/hpo_train.mdx b/docs/source/en/hpo_train.md
similarity index 96%
rename from docs/source/en/hpo_train.mdx
rename to docs/source/en/hpo_train.md
index 5a7cc429ac..e78fc4fd39 100644
--- a/docs/source/en/hpo_train.mdx
+++ b/docs/source/en/hpo_train.md
@@ -7,6 +7,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # Hyperparameter Search using Trainer API
diff --git a/docs/source/en/index.mdx b/docs/source/en/index.md
similarity index 99%
rename from docs/source/en/index.mdx
rename to docs/source/en/index.md
index 1690b4cb7c..aeb73adf46 100644
--- a/docs/source/en/index.mdx
+++ b/docs/source/en/index.md
@@ -8,6 +8,9 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
 -->
 
 # 🤗 Transformers
diff --git a/docs/source/en/installation.mdx b/docs/source/en/installation.md
similarity index 98%
rename from docs/source/en/installation.mdx
rename to docs/source/en/installation.md
index 2c59d9146b..b011714ab9 100644
--- a/docs/source/en/installation.mdx
+++ b/docs/source/en/installation.md
@@ -12,6 +12,10 @@ distributed under the License is distributed on an "AS IS" BASIS,
 WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 See the License for the specific language governing permissions and
 limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # Installation
diff --git a/docs/source/en/internal/audio_utils.mdx b/docs/source/en/internal/audio_utils.md
similarity index 88%
rename from docs/source/en/internal/audio_utils.mdx
rename to docs/source/en/internal/audio_utils.md
index 74c2fe82a3..e6a39c7c1c 100644
--- a/docs/source/en/internal/audio_utils.mdx
+++ b/docs/source/en/internal/audio_utils.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # Utilities for `FeatureExtractors`
diff --git a/docs/source/en/internal/file_utils.mdx b/docs/source/en/internal/file_utils.md
similarity index 88%
rename from docs/source/en/internal/file_utils.mdx
rename to docs/source/en/internal/file_utils.md
index 9366293143..6f5657f774 100644
--- a/docs/source/en/internal/file_utils.mdx
+++ b/docs/source/en/internal/file_utils.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # General Utilities
diff --git a/docs/source/en/internal/generation_utils.mdx b/docs/source/en/internal/generation_utils.md
similarity index 97%
rename from docs/source/en/internal/generation_utils.mdx
rename to docs/source/en/internal/generation_utils.md
index 10b050b3f8..c158be36ba 100644
--- a/docs/source/en/internal/generation_utils.mdx
+++ b/docs/source/en/internal/generation_utils.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # Utilities for Generation
diff --git a/docs/source/en/internal/image_processing_utils.mdx b/docs/source/en/internal/image_processing_utils.md
similarity index 89%
rename from docs/source/en/internal/image_processing_utils.mdx
rename to docs/source/en/internal/image_processing_utils.md
index 831458beda..42f99f3617 100644
--- a/docs/source/en/internal/image_processing_utils.mdx
+++ b/docs/source/en/internal/image_processing_utils.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # Utilities for Image Processors
diff --git a/docs/source/en/internal/modeling_utils.mdx b/docs/source/en/internal/modeling_utils.md
similarity index 92%
rename from docs/source/en/internal/modeling_utils.mdx
rename to docs/source/en/internal/modeling_utils.md
index 578740df02..afc8123558 100644
--- a/docs/source/en/internal/modeling_utils.mdx
+++ b/docs/source/en/internal/modeling_utils.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # Custom Layers and Utilities
diff --git a/docs/source/en/internal/pipelines_utils.mdx b/docs/source/en/internal/pipelines_utils.md
similarity index 87%
rename from docs/source/en/internal/pipelines_utils.mdx
rename to docs/source/en/internal/pipelines_utils.md
index ed8e75b414..6ea6de9a61 100644
--- a/docs/source/en/internal/pipelines_utils.mdx
+++ b/docs/source/en/internal/pipelines_utils.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # Utilities for pipelines
diff --git a/docs/source/en/internal/time_series_utils.mdx b/docs/source/en/internal/time_series_utils.md
similarity index 86%
rename from docs/source/en/internal/time_series_utils.mdx
rename to docs/source/en/internal/time_series_utils.md
index 7ee9b3ecef..11c562fbe3 100644
--- a/docs/source/en/internal/time_series_utils.mdx
+++ b/docs/source/en/internal/time_series_utils.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # Time Series Utilities
diff --git a/docs/source/en/internal/tokenization_utils.mdx b/docs/source/en/internal/tokenization_utils.md
similarity index 89%
rename from docs/source/en/internal/tokenization_utils.mdx
rename to docs/source/en/internal/tokenization_utils.md
index 24e81f7020..5aa6509917 100644
--- a/docs/source/en/internal/tokenization_utils.mdx
+++ b/docs/source/en/internal/tokenization_utils.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # Utilities for Tokenizers
diff --git a/docs/source/en/internal/trainer_utils.mdx b/docs/source/en/internal/trainer_utils.md
similarity index 87%
rename from docs/source/en/internal/trainer_utils.mdx
rename to docs/source/en/internal/trainer_utils.md
index bba182d5ab..e3f8a9b045 100644
--- a/docs/source/en/internal/trainer_utils.mdx
+++ b/docs/source/en/internal/trainer_utils.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # Utilities for Trainer
diff --git a/docs/source/en/main_classes/agent.mdx b/docs/source/en/main_classes/agent.md
similarity index 94%
rename from docs/source/en/main_classes/agent.mdx
rename to docs/source/en/main_classes/agent.md
index 37e9f00ecb..4b29e15721 100644
--- a/docs/source/en/main_classes/agent.mdx
+++ b/docs/source/en/main_classes/agent.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # Agents & Tools
diff --git a/docs/source/en/main_classes/callback.mdx b/docs/source/en/main_classes/callback.md
similarity index 96%
rename from docs/source/en/main_classes/callback.mdx
rename to docs/source/en/main_classes/callback.md
index 2636130473..ccfdf25683 100644
--- a/docs/source/en/main_classes/callback.mdx
+++ b/docs/source/en/main_classes/callback.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # Callbacks
diff --git a/docs/source/en/main_classes/configuration.mdx b/docs/source/en/main_classes/configuration.md
similarity index 87%
rename from docs/source/en/main_classes/configuration.mdx
rename to docs/source/en/main_classes/configuration.md
index 541781eff7..0cfef06d3c 100644
--- a/docs/source/en/main_classes/configuration.mdx
+++ b/docs/source/en/main_classes/configuration.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # Configuration
diff --git a/docs/source/en/main_classes/data_collator.mdx b/docs/source/en/main_classes/data_collator.md
similarity index 92%
rename from docs/source/en/main_classes/data_collator.mdx
rename to docs/source/en/main_classes/data_collator.md
index ee1c1418e4..74e653dd11 100644
--- a/docs/source/en/main_classes/data_collator.mdx
+++ b/docs/source/en/main_classes/data_collator.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # Data Collator
diff --git a/docs/source/en/main_classes/deepspeed.mdx b/docs/source/en/main_classes/deepspeed.md
similarity index 99%
rename from docs/source/en/main_classes/deepspeed.mdx
rename to docs/source/en/main_classes/deepspeed.md
index 3733b0a1b8..bb0cd54372 100644
--- a/docs/source/en/main_classes/deepspeed.mdx
+++ b/docs/source/en/main_classes/deepspeed.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # DeepSpeed Integration
diff --git a/docs/source/en/main_classes/feature_extractor.mdx b/docs/source/en/main_classes/feature_extractor.md
similarity index 88%
rename from docs/source/en/main_classes/feature_extractor.mdx
rename to docs/source/en/main_classes/feature_extractor.md
index 41ee21e4b1..029034fa60 100644
--- a/docs/source/en/main_classes/feature_extractor.mdx
+++ b/docs/source/en/main_classes/feature_extractor.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # Feature Extractor
diff --git a/docs/source/en/main_classes/image_processor.mdx b/docs/source/en/main_classes/image_processor.md
similarity index 87%
rename from docs/source/en/main_classes/image_processor.mdx
rename to docs/source/en/main_classes/image_processor.md
index 6a10839721..04a3cd1337 100644
--- a/docs/source/en/main_classes/image_processor.mdx
+++ b/docs/source/en/main_classes/image_processor.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # Image Processor
diff --git a/docs/source/en/main_classes/keras_callbacks.mdx b/docs/source/en/main_classes/keras_callbacks.md
similarity index 83%
rename from docs/source/en/main_classes/keras_callbacks.mdx
rename to docs/source/en/main_classes/keras_callbacks.md
index bc44a0967c..c9932300db 100644
--- a/docs/source/en/main_classes/keras_callbacks.mdx
+++ b/docs/source/en/main_classes/keras_callbacks.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # Keras callbacks
diff --git a/docs/source/en/main_classes/logging.mdx b/docs/source/en/main_classes/logging.md
similarity index 95%
rename from docs/source/en/main_classes/logging.mdx
rename to docs/source/en/main_classes/logging.md
index 9d4432a729..d117281f65 100644
--- a/docs/source/en/main_classes/logging.mdx
+++ b/docs/source/en/main_classes/logging.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # Logging
diff --git a/docs/source/en/main_classes/model.mdx b/docs/source/en/main_classes/model.md
similarity index 97%
rename from docs/source/en/main_classes/model.mdx
rename to docs/source/en/main_classes/model.md
index fee685b3ef..f4ac72c405 100644
--- a/docs/source/en/main_classes/model.mdx
+++ b/docs/source/en/main_classes/model.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # Models
diff --git a/docs/source/en/main_classes/onnx.mdx b/docs/source/en/main_classes/onnx.md
similarity index 90%
rename from docs/source/en/main_classes/onnx.mdx
rename to docs/source/en/main_classes/onnx.md
index ff20f315a1..81d31c97e8 100644
--- a/docs/source/en/main_classes/onnx.mdx
+++ b/docs/source/en/main_classes/onnx.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # Exporting 🤗 Transformers models to ONNX
diff --git a/docs/source/en/main_classes/optimizer_schedules.mdx b/docs/source/en/main_classes/optimizer_schedules.md
similarity index 92%
rename from docs/source/en/main_classes/optimizer_schedules.mdx
rename to docs/source/en/main_classes/optimizer_schedules.md
index 4808f4a2a4..dfcab9e914 100644
--- a/docs/source/en/main_classes/optimizer_schedules.mdx
+++ b/docs/source/en/main_classes/optimizer_schedules.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # Optimization
diff --git a/docs/source/en/main_classes/output.mdx b/docs/source/en/main_classes/output.md
similarity index 98%
rename from docs/source/en/main_classes/output.mdx
rename to docs/source/en/main_classes/output.md
index 921031671c..93e1d78054 100644
--- a/docs/source/en/main_classes/output.mdx
+++ b/docs/source/en/main_classes/output.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # Model outputs
diff --git a/docs/source/en/main_classes/pipelines.mdx b/docs/source/en/main_classes/pipelines.md
similarity index 98%
rename from docs/source/en/main_classes/pipelines.mdx
rename to docs/source/en/main_classes/pipelines.md
index d64c7ee3f0..94272b4383 100644
--- a/docs/source/en/main_classes/pipelines.mdx
+++ b/docs/source/en/main_classes/pipelines.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # Pipelines
diff --git a/docs/source/en/main_classes/processors.mdx b/docs/source/en/main_classes/processors.md
similarity index 97%
rename from docs/source/en/main_classes/processors.mdx
rename to docs/source/en/main_classes/processors.md
index 5530720b1c..9763122ef4 100644
--- a/docs/source/en/main_classes/processors.mdx
+++ b/docs/source/en/main_classes/processors.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # Processors
diff --git a/docs/source/en/main_classes/quantization.mdx b/docs/source/en/main_classes/quantization.md
similarity index 98%
rename from docs/source/en/main_classes/quantization.mdx
rename to docs/source/en/main_classes/quantization.md
index e093bc3baf..eb360e603a 100644
--- a/docs/source/en/main_classes/quantization.mdx
+++ b/docs/source/en/main_classes/quantization.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # Quantize 🤗 Transformers models
diff --git a/docs/source/en/main_classes/text_generation.mdx b/docs/source/en/main_classes/text_generation.md
similarity index 92%
rename from docs/source/en/main_classes/text_generation.mdx
rename to docs/source/en/main_classes/text_generation.md
index 39a1516034..309d7298ee 100644
--- a/docs/source/en/main_classes/text_generation.mdx
+++ b/docs/source/en/main_classes/text_generation.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # Generation
diff --git a/docs/source/en/main_classes/tokenizer.mdx b/docs/source/en/main_classes/tokenizer.md
similarity index 95%
rename from docs/source/en/main_classes/tokenizer.mdx
rename to docs/source/en/main_classes/tokenizer.md
index 032373435c..251cbb43ea 100644
--- a/docs/source/en/main_classes/tokenizer.mdx
+++ b/docs/source/en/main_classes/tokenizer.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # Tokenizer
diff --git a/docs/source/en/main_classes/trainer.mdx b/docs/source/en/main_classes/trainer.md
similarity index 99%
rename from docs/source/en/main_classes/trainer.mdx
rename to docs/source/en/main_classes/trainer.md
index 9a941964a5..c74b764c5e 100644
--- a/docs/source/en/main_classes/trainer.mdx
+++ b/docs/source/en/main_classes/trainer.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # Trainer
diff --git a/docs/source/en/model_doc/albert.mdx b/docs/source/en/model_doc/albert.md
similarity index 97%
rename from docs/source/en/model_doc/albert.mdx
rename to docs/source/en/model_doc/albert.md
index 5076a5150b..9e821f2f4d 100644
--- a/docs/source/en/model_doc/albert.mdx
+++ b/docs/source/en/model_doc/albert.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # ALBERT
diff --git a/docs/source/en/model_doc/align.mdx b/docs/source/en/model_doc/align.md
similarity index 97%
rename from docs/source/en/model_doc/align.mdx
rename to docs/source/en/model_doc/align.md
index 159c3b2a0d..faf76853f6 100644
--- a/docs/source/en/model_doc/align.mdx
+++ b/docs/source/en/model_doc/align.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # ALIGN
diff --git a/docs/source/en/model_doc/altclip.mdx b/docs/source/en/model_doc/altclip.md
similarity index 96%
rename from docs/source/en/model_doc/altclip.mdx
rename to docs/source/en/model_doc/altclip.md
index 681bea22c7..23cdcb63fb 100644
--- a/docs/source/en/model_doc/altclip.mdx
+++ b/docs/source/en/model_doc/altclip.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # AltCLIP
diff --git a/docs/source/en/model_doc/audio-spectrogram-transformer.mdx b/docs/source/en/model_doc/audio-spectrogram-transformer.md
similarity index 96%
rename from docs/source/en/model_doc/audio-spectrogram-transformer.mdx
rename to docs/source/en/model_doc/audio-spectrogram-transformer.md
index f4a8f71d97..df9fe78c2d 100644
--- a/docs/source/en/model_doc/audio-spectrogram-transformer.mdx
+++ b/docs/source/en/model_doc/audio-spectrogram-transformer.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # Audio Spectrogram Transformer
diff --git a/docs/source/en/model_doc/auto.mdx b/docs/source/en/model_doc/auto.md
similarity index 97%
rename from docs/source/en/model_doc/auto.mdx
rename to docs/source/en/model_doc/auto.md
index 0f82f383da..722cafa875 100644
--- a/docs/source/en/model_doc/auto.mdx
+++ b/docs/source/en/model_doc/auto.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # Auto Classes
diff --git a/docs/source/en/model_doc/autoformer.mdx b/docs/source/en/model_doc/autoformer.md
similarity index 94%
rename from docs/source/en/model_doc/autoformer.mdx
rename to docs/source/en/model_doc/autoformer.md
index c1bd30555c..f50705d0e3 100644
--- a/docs/source/en/model_doc/autoformer.mdx
+++ b/docs/source/en/model_doc/autoformer.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # Autoformer
diff --git a/docs/source/en/model_doc/bart.mdx b/docs/source/en/model_doc/bart.md
similarity index 98%
rename from docs/source/en/model_doc/bart.mdx
rename to docs/source/en/model_doc/bart.md
index ef4bebd017..dcf149fd85 100644
--- a/docs/source/en/model_doc/bart.mdx
+++ b/docs/source/en/model_doc/bart.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # BART
diff --git a/docs/source/en/model_doc/barthez.mdx b/docs/source/en/model_doc/barthez.md
similarity index 94%
rename from docs/source/en/model_doc/barthez.mdx
rename to docs/source/en/model_doc/barthez.md
index f1969e8e94..fdeb8e2fed 100644
--- a/docs/source/en/model_doc/barthez.mdx
+++ b/docs/source/en/model_doc/barthez.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # BARThez
diff --git a/docs/source/en/model_doc/bartpho.mdx b/docs/source/en/model_doc/bartpho.md
similarity index 95%
rename from docs/source/en/model_doc/bartpho.mdx
rename to docs/source/en/model_doc/bartpho.md
index d940173b42..3529c11a7e 100644
--- a/docs/source/en/model_doc/bartpho.mdx
+++ b/docs/source/en/model_doc/bartpho.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # BARTpho
diff --git a/docs/source/en/model_doc/beit.mdx b/docs/source/en/model_doc/beit.md
similarity index 97%
rename from docs/source/en/model_doc/beit.mdx
rename to docs/source/en/model_doc/beit.md
index c9ca2ee992..6958672471 100644
--- a/docs/source/en/model_doc/beit.mdx
+++ b/docs/source/en/model_doc/beit.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # BEiT
diff --git a/docs/source/en/model_doc/bert-generation.mdx b/docs/source/en/model_doc/bert-generation.md
similarity index 96%
rename from docs/source/en/model_doc/bert-generation.mdx
rename to docs/source/en/model_doc/bert-generation.md
index e300917ea5..9cc7bac6c7 100644
--- a/docs/source/en/model_doc/bert-generation.mdx
+++ b/docs/source/en/model_doc/bert-generation.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # BertGeneration
diff --git a/docs/source/en/model_doc/bert-japanese.mdx b/docs/source/en/model_doc/bert-japanese.md
similarity index 93%
rename from docs/source/en/model_doc/bert-japanese.mdx
rename to docs/source/en/model_doc/bert-japanese.md
index 312714b379..208b775307 100644
--- a/docs/source/en/model_doc/bert-japanese.mdx
+++ b/docs/source/en/model_doc/bert-japanese.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # BertJapanese
diff --git a/docs/source/en/model_doc/bert.mdx b/docs/source/en/model_doc/bert.md
similarity index 98%
rename from docs/source/en/model_doc/bert.mdx
rename to docs/source/en/model_doc/bert.md
index eae3bce130..19d15cfc05 100644
--- a/docs/source/en/model_doc/bert.mdx
+++ b/docs/source/en/model_doc/bert.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # BERT
diff --git a/docs/source/en/model_doc/bertweet.mdx b/docs/source/en/model_doc/bertweet.md
similarity index 93%
rename from docs/source/en/model_doc/bertweet.mdx
rename to docs/source/en/model_doc/bertweet.md
index df55360646..50629445ae 100644
--- a/docs/source/en/model_doc/bertweet.mdx
+++ b/docs/source/en/model_doc/bertweet.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # BERTweet
diff --git a/docs/source/en/model_doc/big_bird.mdx b/docs/source/en/model_doc/big_bird.md
similarity index 97%
rename from docs/source/en/model_doc/big_bird.mdx
rename to docs/source/en/model_doc/big_bird.md
index 22bc4debf4..b8bbb388d6 100644
--- a/docs/source/en/model_doc/big_bird.mdx
+++ b/docs/source/en/model_doc/big_bird.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # BigBird
diff --git a/docs/source/en/model_doc/bigbird_pegasus.mdx b/docs/source/en/model_doc/bigbird_pegasus.md
similarity index 96%
rename from docs/source/en/model_doc/bigbird_pegasus.mdx
rename to docs/source/en/model_doc/bigbird_pegasus.md
index 00ccb88dc0..d767f548a7 100644
--- a/docs/source/en/model_doc/bigbird_pegasus.mdx
+++ b/docs/source/en/model_doc/bigbird_pegasus.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # BigBirdPegasus
diff --git a/docs/source/en/model_doc/biogpt.mdx b/docs/source/en/model_doc/biogpt.md
similarity index 95%
rename from docs/source/en/model_doc/biogpt.mdx
rename to docs/source/en/model_doc/biogpt.md
index 37b23402c2..29327df21a 100644
--- a/docs/source/en/model_doc/biogpt.mdx
+++ b/docs/source/en/model_doc/biogpt.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # BioGPT
diff --git a/docs/source/en/model_doc/bit.mdx b/docs/source/en/model_doc/bit.md
similarity index 95%
rename from docs/source/en/model_doc/bit.mdx
rename to docs/source/en/model_doc/bit.md
index 343832e62e..80b9fdd2ca 100644
--- a/docs/source/en/model_doc/bit.mdx
+++ b/docs/source/en/model_doc/bit.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # Big Transfer (BiT)
diff --git a/docs/source/en/model_doc/blenderbot-small.mdx b/docs/source/en/model_doc/blenderbot-small.md
similarity index 95%
rename from docs/source/en/model_doc/blenderbot-small.mdx
rename to docs/source/en/model_doc/blenderbot-small.md
index fa3d32ab0e..c126bc9b14 100644
--- a/docs/source/en/model_doc/blenderbot-small.mdx
+++ b/docs/source/en/model_doc/blenderbot-small.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # Blenderbot Small
diff --git a/docs/source/en/model_doc/blenderbot.mdx b/docs/source/en/model_doc/blenderbot.md
similarity index 96%
rename from docs/source/en/model_doc/blenderbot.mdx
rename to docs/source/en/model_doc/blenderbot.md
index 485b4ca1e0..5a10af77b6 100644
--- a/docs/source/en/model_doc/blenderbot.mdx
+++ b/docs/source/en/model_doc/blenderbot.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # Blenderbot
diff --git a/docs/source/en/model_doc/blip-2.mdx b/docs/source/en/model_doc/blip-2.md
similarity index 96%
rename from docs/source/en/model_doc/blip-2.mdx
rename to docs/source/en/model_doc/blip-2.md
index 57b380f99f..0890e61256 100644
--- a/docs/source/en/model_doc/blip-2.mdx
+++ b/docs/source/en/model_doc/blip-2.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # BLIP-2
diff --git a/docs/source/en/model_doc/blip.mdx b/docs/source/en/model_doc/blip.md
similarity index 95%
rename from docs/source/en/model_doc/blip.mdx
rename to docs/source/en/model_doc/blip.md
index 12cc26f418..a67e7411c3 100644
--- a/docs/source/en/model_doc/blip.mdx
+++ b/docs/source/en/model_doc/blip.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # BLIP
diff --git a/docs/source/en/model_doc/bloom.mdx b/docs/source/en/model_doc/bloom.md
similarity index 95%
rename from docs/source/en/model_doc/bloom.mdx
rename to docs/source/en/model_doc/bloom.md
index 3f30f14706..3fba4af3de 100644
--- a/docs/source/en/model_doc/bloom.mdx
+++ b/docs/source/en/model_doc/bloom.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # BLOOM
diff --git a/docs/source/en/model_doc/bort.mdx b/docs/source/en/model_doc/bort.md
similarity index 94%
rename from docs/source/en/model_doc/bort.mdx
rename to docs/source/en/model_doc/bort.md
index e90f042b65..23f004cc9b 100644
--- a/docs/source/en/model_doc/bort.mdx
+++ b/docs/source/en/model_doc/bort.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # BORT
diff --git a/docs/source/en/model_doc/bridgetower.mdx b/docs/source/en/model_doc/bridgetower.md
similarity index 97%
rename from docs/source/en/model_doc/bridgetower.mdx
rename to docs/source/en/model_doc/bridgetower.md
index 9f7572f312..ba98cea91d 100644
--- a/docs/source/en/model_doc/bridgetower.mdx
+++ b/docs/source/en/model_doc/bridgetower.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # BridgeTower
diff --git a/docs/source/en/model_doc/byt5.mdx b/docs/source/en/model_doc/byt5.md
similarity index 97%
rename from docs/source/en/model_doc/byt5.mdx
rename to docs/source/en/model_doc/byt5.md
index dc4c5a6caf..2df7c4ddaa 100644
--- a/docs/source/en/model_doc/byt5.mdx
+++ b/docs/source/en/model_doc/byt5.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # ByT5
diff --git a/docs/source/en/model_doc/camembert.mdx b/docs/source/en/model_doc/camembert.md
similarity index 95%
rename from docs/source/en/model_doc/camembert.mdx
rename to docs/source/en/model_doc/camembert.md
index 4299603613..3ec4cd5dd0 100644
--- a/docs/source/en/model_doc/camembert.mdx
+++ b/docs/source/en/model_doc/camembert.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # CamemBERT
diff --git a/docs/source/en/model_doc/canine.mdx b/docs/source/en/model_doc/canine.md
similarity index 97%
rename from docs/source/en/model_doc/canine.mdx
rename to docs/source/en/model_doc/canine.md
index b23da136d3..748ec63ecc 100644
--- a/docs/source/en/model_doc/canine.mdx
+++ b/docs/source/en/model_doc/canine.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # CANINE
diff --git a/docs/source/en/model_doc/chinese_clip.mdx b/docs/source/en/model_doc/chinese_clip.md
similarity index 96%
rename from docs/source/en/model_doc/chinese_clip.mdx
rename to docs/source/en/model_doc/chinese_clip.md
index d8973759ed..430a734014 100644
--- a/docs/source/en/model_doc/chinese_clip.mdx
+++ b/docs/source/en/model_doc/chinese_clip.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # Chinese-CLIP
diff --git a/docs/source/en/model_doc/clap.mdx b/docs/source/en/model_doc/clap.md
similarity index 95%
rename from docs/source/en/model_doc/clap.mdx
rename to docs/source/en/model_doc/clap.md
index 2074934deb..54082ec8aa 100644
--- a/docs/source/en/model_doc/clap.mdx
+++ b/docs/source/en/model_doc/clap.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # CLAP
diff --git a/docs/source/en/model_doc/clip.mdx b/docs/source/en/model_doc/clip.md
similarity index 97%
rename from docs/source/en/model_doc/clip.mdx
rename to docs/source/en/model_doc/clip.md
index 790bce6c7f..7bd40fc05b 100644
--- a/docs/source/en/model_doc/clip.mdx
+++ b/docs/source/en/model_doc/clip.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # CLIP
diff --git a/docs/source/en/model_doc/clipseg.mdx b/docs/source/en/model_doc/clipseg.md
similarity index 96%
rename from docs/source/en/model_doc/clipseg.mdx
rename to docs/source/en/model_doc/clipseg.md
index 94b58275f6..c4c60a48d0 100644
--- a/docs/source/en/model_doc/clipseg.mdx
+++ b/docs/source/en/model_doc/clipseg.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # CLIPSeg
diff --git a/docs/source/en/model_doc/codegen.mdx b/docs/source/en/model_doc/codegen.md
similarity index 96%
rename from docs/source/en/model_doc/codegen.mdx
rename to docs/source/en/model_doc/codegen.md
index bc6de54b4e..695f45f9ae 100644
--- a/docs/source/en/model_doc/codegen.mdx
+++ b/docs/source/en/model_doc/codegen.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # CodeGen
diff --git a/docs/source/en/model_doc/conditional_detr.mdx b/docs/source/en/model_doc/conditional_detr.md
similarity index 95%
rename from docs/source/en/model_doc/conditional_detr.mdx
rename to docs/source/en/model_doc/conditional_detr.md
index 0adb028908..4dff1d0e35 100644
--- a/docs/source/en/model_doc/conditional_detr.mdx
+++ b/docs/source/en/model_doc/conditional_detr.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # Conditional DETR
diff --git a/docs/source/en/model_doc/convbert.mdx b/docs/source/en/model_doc/convbert.md
similarity index 96%
rename from docs/source/en/model_doc/convbert.mdx
rename to docs/source/en/model_doc/convbert.md
index cc2a79f961..8a0aa7a946 100644
--- a/docs/source/en/model_doc/convbert.mdx
+++ b/docs/source/en/model_doc/convbert.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # ConvBERT
diff --git a/docs/source/en/model_doc/convnext.mdx b/docs/source/en/model_doc/convnext.md
similarity index 96%
rename from docs/source/en/model_doc/convnext.mdx
rename to docs/source/en/model_doc/convnext.md
index 3da76eb0e0..acbb0265b2 100644
--- a/docs/source/en/model_doc/convnext.mdx
+++ b/docs/source/en/model_doc/convnext.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # ConvNeXT
diff --git a/docs/source/en/model_doc/convnextv2.mdx b/docs/source/en/model_doc/convnextv2.md
similarity index 95%
rename from docs/source/en/model_doc/convnextv2.mdx
rename to docs/source/en/model_doc/convnextv2.md
index 6572854bfa..9479cdd56f 100644
--- a/docs/source/en/model_doc/convnextv2.mdx
+++ b/docs/source/en/model_doc/convnextv2.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # ConvNeXt V2
diff --git a/docs/source/en/model_doc/cpm.mdx b/docs/source/en/model_doc/cpm.md
similarity index 93%
rename from docs/source/en/model_doc/cpm.mdx
rename to docs/source/en/model_doc/cpm.md
index ac8ed8fdba..a2ecf1a1e0 100644
--- a/docs/source/en/model_doc/cpm.mdx
+++ b/docs/source/en/model_doc/cpm.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # CPM
diff --git a/docs/source/en/model_doc/cpmant.mdx b/docs/source/en/model_doc/cpmant.md
similarity index 90%
rename from docs/source/en/model_doc/cpmant.mdx
rename to docs/source/en/model_doc/cpmant.md
index 8f855355b3..2c4ad92a62 100644
--- a/docs/source/en/model_doc/cpmant.mdx
+++ b/docs/source/en/model_doc/cpmant.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # CPMAnt
diff --git a/docs/source/en/model_doc/ctrl.mdx b/docs/source/en/model_doc/ctrl.md
similarity index 96%
rename from docs/source/en/model_doc/ctrl.mdx
rename to docs/source/en/model_doc/ctrl.md
index 5b42fbe7c3..9c2413d277 100644
--- a/docs/source/en/model_doc/ctrl.mdx
+++ b/docs/source/en/model_doc/ctrl.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # CTRL
diff --git a/docs/source/en/model_doc/cvt.mdx b/docs/source/en/model_doc/cvt.md
similarity index 96%
rename from docs/source/en/model_doc/cvt.mdx
rename to docs/source/en/model_doc/cvt.md
index 3c58c5b7a2..6c9aea5ec8 100644
--- a/docs/source/en/model_doc/cvt.mdx
+++ b/docs/source/en/model_doc/cvt.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # Convolutional Vision Transformer (CvT)
diff --git a/docs/source/en/model_doc/data2vec.mdx b/docs/source/en/model_doc/data2vec.md
similarity index 97%
rename from docs/source/en/model_doc/data2vec.mdx
rename to docs/source/en/model_doc/data2vec.md
index 091d34a163..dc05c44be9 100644
--- a/docs/source/en/model_doc/data2vec.mdx
+++ b/docs/source/en/model_doc/data2vec.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # Data2Vec
diff --git a/docs/source/en/model_doc/deberta-v2.mdx b/docs/source/en/model_doc/deberta-v2.md
similarity index 97%
rename from docs/source/en/model_doc/deberta-v2.mdx
rename to docs/source/en/model_doc/deberta-v2.md
index 74d537cf22..38f575877e 100644
--- a/docs/source/en/model_doc/deberta-v2.mdx
+++ b/docs/source/en/model_doc/deberta-v2.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # DeBERTa-v2
diff --git a/docs/source/en/model_doc/deberta.mdx b/docs/source/en/model_doc/deberta.md
similarity index 97%
rename from docs/source/en/model_doc/deberta.mdx
rename to docs/source/en/model_doc/deberta.md
index 8faf2e1c28..ed66364a4b 100644
--- a/docs/source/en/model_doc/deberta.mdx
+++ b/docs/source/en/model_doc/deberta.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # DeBERTa
diff --git a/docs/source/en/model_doc/decision_transformer.mdx b/docs/source/en/model_doc/decision_transformer.md
similarity index 93%
rename from docs/source/en/model_doc/decision_transformer.mdx
rename to docs/source/en/model_doc/decision_transformer.md
index 2f0c70b679..a46673d87a 100644
--- a/docs/source/en/model_doc/decision_transformer.mdx
+++ b/docs/source/en/model_doc/decision_transformer.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # Decision Transformer
diff --git a/docs/source/en/model_doc/deformable_detr.mdx b/docs/source/en/model_doc/deformable_detr.md
similarity index 95%
rename from docs/source/en/model_doc/deformable_detr.mdx
rename to docs/source/en/model_doc/deformable_detr.md
index 16ea70511b..a9b1267c15 100644
--- a/docs/source/en/model_doc/deformable_detr.mdx
+++ b/docs/source/en/model_doc/deformable_detr.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # Deformable DETR
diff --git a/docs/source/en/model_doc/deit.mdx b/docs/source/en/model_doc/deit.md
similarity index 97%
rename from docs/source/en/model_doc/deit.mdx
rename to docs/source/en/model_doc/deit.md
index 306915e748..ef32e05ebd 100644
--- a/docs/source/en/model_doc/deit.mdx
+++ b/docs/source/en/model_doc/deit.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # DeiT
diff --git a/docs/source/en/model_doc/deplot.mdx b/docs/source/en/model_doc/deplot.md
similarity index 96%
rename from docs/source/en/model_doc/deplot.mdx
rename to docs/source/en/model_doc/deplot.md
index 8949e22ceb..f425a8268f 100644
--- a/docs/source/en/model_doc/deplot.mdx
+++ b/docs/source/en/model_doc/deplot.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # DePlot
diff --git a/docs/source/en/model_doc/deta.mdx b/docs/source/en/model_doc/deta.md
similarity index 95%
rename from docs/source/en/model_doc/deta.mdx
rename to docs/source/en/model_doc/deta.md
index 9b45e44753..d384f5564e 100644
--- a/docs/source/en/model_doc/deta.mdx
+++ b/docs/source/en/model_doc/deta.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # DETA
diff --git a/docs/source/en/model_doc/detr.mdx b/docs/source/en/model_doc/detr.md
similarity index 98%
rename from docs/source/en/model_doc/detr.mdx
rename to docs/source/en/model_doc/detr.md
index 57fbd04e18..a83f3097bf 100644
--- a/docs/source/en/model_doc/detr.mdx
+++ b/docs/source/en/model_doc/detr.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # DETR
diff --git a/docs/source/en/model_doc/dialogpt.mdx b/docs/source/en/model_doc/dialogpt.md
similarity index 94%
rename from docs/source/en/model_doc/dialogpt.mdx
rename to docs/source/en/model_doc/dialogpt.md
index 62c6b45130..70929409b2 100644
--- a/docs/source/en/model_doc/dialogpt.mdx
+++ b/docs/source/en/model_doc/dialogpt.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # DialoGPT
diff --git a/docs/source/en/model_doc/dinat.mdx b/docs/source/en/model_doc/dinat.md
similarity index 96%
rename from docs/source/en/model_doc/dinat.mdx
rename to docs/source/en/model_doc/dinat.md
index 2ddbc63224..2317b13b7f 100644
--- a/docs/source/en/model_doc/dinat.mdx
+++ b/docs/source/en/model_doc/dinat.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # Dilated Neighborhood Attention Transformer
diff --git a/docs/source/en/model_doc/distilbert.mdx b/docs/source/en/model_doc/distilbert.md
similarity index 98%
rename from docs/source/en/model_doc/distilbert.mdx
rename to docs/source/en/model_doc/distilbert.md
index 837f0319ec..2e68119a20 100644
--- a/docs/source/en/model_doc/distilbert.mdx
+++ b/docs/source/en/model_doc/distilbert.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # DistilBERT
diff --git a/docs/source/en/model_doc/dit.mdx b/docs/source/en/model_doc/dit.md
similarity index 96%
rename from docs/source/en/model_doc/dit.mdx
rename to docs/source/en/model_doc/dit.md
index 4843ca71f5..7d5f873e78 100644
--- a/docs/source/en/model_doc/dit.mdx
+++ b/docs/source/en/model_doc/dit.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # DiT
diff --git a/docs/source/en/model_doc/donut.mdx b/docs/source/en/model_doc/donut.md
similarity index 98%
rename from docs/source/en/model_doc/donut.mdx
rename to docs/source/en/model_doc/donut.md
index 62ce32fd9c..6ccfe39dbb 100644
--- a/docs/source/en/model_doc/donut.mdx
+++ b/docs/source/en/model_doc/donut.md
@@ -7,6 +7,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an
 "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 specific language governing permissions and limitations under the License. -->
 
 # Donut
diff --git a/docs/source/en/model_doc/dpr.mdx b/docs/source/en/model_doc/dpr.md
similarity index 95%
rename from docs/source/en/model_doc/dpr.mdx
rename to docs/source/en/model_doc/dpr.md
index 12c139e33b..10bc76b72d 100644
--- a/docs/source/en/model_doc/dpr.mdx
+++ b/docs/source/en/model_doc/dpr.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # DPR
diff --git a/docs/source/en/model_doc/dpt.mdx b/docs/source/en/model_doc/dpt.md
similarity index 95%
rename from docs/source/en/model_doc/dpt.mdx
rename to docs/source/en/model_doc/dpt.md
index e67dfde084..5e3e25343c 100644
--- a/docs/source/en/model_doc/dpt.mdx
+++ b/docs/source/en/model_doc/dpt.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # DPT
diff --git a/docs/source/en/model_doc/efficientformer.mdx b/docs/source/en/model_doc/efficientformer.md
similarity index 95%
rename from docs/source/en/model_doc/efficientformer.mdx
rename to docs/source/en/model_doc/efficientformer.md
index 0ef8cfb53f..1f16f9811b 100644
--- a/docs/source/en/model_doc/efficientformer.mdx
+++ b/docs/source/en/model_doc/efficientformer.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # EfficientFormer
diff --git a/docs/source/en/model_doc/efficientnet.mdx b/docs/source/en/model_doc/efficientnet.md
similarity index 94%
rename from docs/source/en/model_doc/efficientnet.mdx
rename to docs/source/en/model_doc/efficientnet.md
index 6aeec7651c..a69b255dba 100644
--- a/docs/source/en/model_doc/efficientnet.mdx
+++ b/docs/source/en/model_doc/efficientnet.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # EfficientNet
diff --git a/docs/source/en/model_doc/electra.mdx b/docs/source/en/model_doc/electra.md
similarity index 97%
rename from docs/source/en/model_doc/electra.mdx
rename to docs/source/en/model_doc/electra.md
index e0422dbae5..26830950ae 100644
--- a/docs/source/en/model_doc/electra.mdx
+++ b/docs/source/en/model_doc/electra.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # ELECTRA
diff --git a/docs/source/en/model_doc/encodec.mdx b/docs/source/en/model_doc/encodec.md
similarity index 95%
rename from docs/source/en/model_doc/encodec.mdx
rename to docs/source/en/model_doc/encodec.md
index f98156db1d..bc7f64676e 100644
--- a/docs/source/en/model_doc/encodec.mdx
+++ b/docs/source/en/model_doc/encodec.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # EnCodec
diff --git a/docs/source/en/model_doc/encoder-decoder.mdx b/docs/source/en/model_doc/encoder-decoder.md
similarity index 98%
rename from docs/source/en/model_doc/encoder-decoder.mdx
rename to docs/source/en/model_doc/encoder-decoder.md
index 8130b4945d..8e26a3b9e4 100644
--- a/docs/source/en/model_doc/encoder-decoder.mdx
+++ b/docs/source/en/model_doc/encoder-decoder.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # Encoder Decoder Models
diff --git a/docs/source/en/model_doc/ernie.mdx b/docs/source/en/model_doc/ernie.md
similarity index 95%
rename from docs/source/en/model_doc/ernie.mdx
rename to docs/source/en/model_doc/ernie.md
index 0159c0f4bc..a64291a7d4 100644
--- a/docs/source/en/model_doc/ernie.mdx
+++ b/docs/source/en/model_doc/ernie.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # ERNIE
diff --git a/docs/source/en/model_doc/ernie_m.mdx b/docs/source/en/model_doc/ernie_m.md
similarity index 95%
rename from docs/source/en/model_doc/ernie_m.mdx
rename to docs/source/en/model_doc/ernie_m.md
index bd04483fc5..83e08e09bf 100644
--- a/docs/source/en/model_doc/ernie_m.mdx
+++ b/docs/source/en/model_doc/ernie_m.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # ErnieM
diff --git a/docs/source/en/model_doc/esm.mdx b/docs/source/en/model_doc/esm.md
similarity index 97%
rename from docs/source/en/model_doc/esm.mdx
rename to docs/source/en/model_doc/esm.md
index ca7c950dab..47b2565084 100644
--- a/docs/source/en/model_doc/esm.mdx
+++ b/docs/source/en/model_doc/esm.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # ESM
diff --git a/docs/source/en/model_doc/flan-t5.mdx b/docs/source/en/model_doc/flan-t5.md
similarity index 93%
rename from docs/source/en/model_doc/flan-t5.mdx
rename to docs/source/en/model_doc/flan-t5.md
index 5a2d6fc934..5d781f75b1 100644
--- a/docs/source/en/model_doc/flan-t5.mdx
+++ b/docs/source/en/model_doc/flan-t5.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # FLAN-T5
diff --git a/docs/source/en/model_doc/flan-ul2.mdx b/docs/source/en/model_doc/flan-ul2.md
similarity index 94%
rename from docs/source/en/model_doc/flan-ul2.mdx
rename to docs/source/en/model_doc/flan-ul2.md
index bcc0029542..e206039208 100644
--- a/docs/source/en/model_doc/flan-ul2.mdx
+++ b/docs/source/en/model_doc/flan-ul2.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # FLAN-UL2
diff --git a/docs/source/en/model_doc/flaubert.mdx b/docs/source/en/model_doc/flaubert.md
similarity index 96%
rename from docs/source/en/model_doc/flaubert.mdx
rename to docs/source/en/model_doc/flaubert.md
index 0e8a1b252a..3e85bd6fa9 100644
--- a/docs/source/en/model_doc/flaubert.mdx
+++ b/docs/source/en/model_doc/flaubert.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # FlauBERT
diff --git a/docs/source/en/model_doc/flava.mdx b/docs/source/en/model_doc/flava.md
similarity index 94%
rename from docs/source/en/model_doc/flava.mdx
rename to docs/source/en/model_doc/flava.md
index 4df11a5758..ae9da0d184 100644
--- a/docs/source/en/model_doc/flava.mdx
+++ b/docs/source/en/model_doc/flava.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # FLAVA
diff --git a/docs/source/en/model_doc/fnet.mdx b/docs/source/en/model_doc/fnet.md
similarity index 96%
rename from docs/source/en/model_doc/fnet.mdx
rename to docs/source/en/model_doc/fnet.md
index 9bf858bee4..a6d862f8a1 100644
--- a/docs/source/en/model_doc/fnet.mdx
+++ b/docs/source/en/model_doc/fnet.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # FNet
diff --git a/docs/source/en/model_doc/focalnet.mdx b/docs/source/en/model_doc/focalnet.md
similarity index 95%
rename from docs/source/en/model_doc/focalnet.mdx
rename to docs/source/en/model_doc/focalnet.md
index e87042e78d..21a75440b1 100644
--- a/docs/source/en/model_doc/focalnet.mdx
+++ b/docs/source/en/model_doc/focalnet.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # FocalNet
diff --git a/docs/source/en/model_doc/fsmt.mdx b/docs/source/en/model_doc/fsmt.md
similarity index 94%
rename from docs/source/en/model_doc/fsmt.mdx
rename to docs/source/en/model_doc/fsmt.md
index 25c8d85cf4..49625f6c47 100644
--- a/docs/source/en/model_doc/fsmt.mdx
+++ b/docs/source/en/model_doc/fsmt.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # FSMT
diff --git a/docs/source/en/model_doc/funnel.mdx b/docs/source/en/model_doc/funnel.md
similarity index 97%
rename from docs/source/en/model_doc/funnel.mdx
rename to docs/source/en/model_doc/funnel.md
index ebbc679278..3cc4eb0aae 100644
--- a/docs/source/en/model_doc/funnel.mdx
+++ b/docs/source/en/model_doc/funnel.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # Funnel Transformer
diff --git a/docs/source/en/model_doc/git.mdx b/docs/source/en/model_doc/git.md
similarity index 95%
rename from docs/source/en/model_doc/git.mdx
rename to docs/source/en/model_doc/git.md
index ac13874d47..b0c96200af 100644
--- a/docs/source/en/model_doc/git.mdx
+++ b/docs/source/en/model_doc/git.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # GIT
diff --git a/docs/source/en/model_doc/glpn.mdx b/docs/source/en/model_doc/glpn.md
similarity index 95%
rename from docs/source/en/model_doc/glpn.mdx
rename to docs/source/en/model_doc/glpn.md
index d1ae7da094..be9a7d2d79 100644
--- a/docs/source/en/model_doc/glpn.mdx
+++ b/docs/source/en/model_doc/glpn.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # GLPN
diff --git a/docs/source/en/model_doc/gpt-sw3.mdx b/docs/source/en/model_doc/gpt-sw3.md
similarity index 94%
rename from docs/source/en/model_doc/gpt-sw3.mdx
rename to docs/source/en/model_doc/gpt-sw3.md
index 2f20937a4c..286cac12c9 100644
--- a/docs/source/en/model_doc/gpt-sw3.mdx
+++ b/docs/source/en/model_doc/gpt-sw3.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # GPT-Sw3
diff --git a/docs/source/en/model_doc/gpt2.mdx b/docs/source/en/model_doc/gpt2.md
similarity index 97%
rename from docs/source/en/model_doc/gpt2.mdx
rename to docs/source/en/model_doc/gpt2.md
index 6288e46eb5..878bf84a3f 100644
--- a/docs/source/en/model_doc/gpt2.mdx
+++ b/docs/source/en/model_doc/gpt2.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # OpenAI GPT2
diff --git a/docs/source/en/model_doc/gpt_bigcode.mdx b/docs/source/en/model_doc/gpt_bigcode.md
similarity index 96%
rename from docs/source/en/model_doc/gpt_bigcode.mdx
rename to docs/source/en/model_doc/gpt_bigcode.md
index b0991567b2..6965d5837d 100644
--- a/docs/source/en/model_doc/gpt_bigcode.mdx
+++ b/docs/source/en/model_doc/gpt_bigcode.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # GPTBigCode
diff --git a/docs/source/en/model_doc/gpt_neo.mdx b/docs/source/en/model_doc/gpt_neo.md
similarity index 94%
rename from docs/source/en/model_doc/gpt_neo.mdx
rename to docs/source/en/model_doc/gpt_neo.md
index a766a85cf1..6b925aad10 100644
--- a/docs/source/en/model_doc/gpt_neo.mdx
+++ b/docs/source/en/model_doc/gpt_neo.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # GPT Neo
diff --git a/docs/source/en/model_doc/gpt_neox.mdx b/docs/source/en/model_doc/gpt_neox.md
similarity index 95%
rename from docs/source/en/model_doc/gpt_neox.mdx
rename to docs/source/en/model_doc/gpt_neox.md
index bc8bbd6733..0ee7c8630c 100644
--- a/docs/source/en/model_doc/gpt_neox.mdx
+++ b/docs/source/en/model_doc/gpt_neox.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # GPT-NeoX
diff --git a/docs/source/en/model_doc/gpt_neox_japanese.mdx b/docs/source/en/model_doc/gpt_neox_japanese.md
similarity index 94%
rename from docs/source/en/model_doc/gpt_neox_japanese.mdx
rename to docs/source/en/model_doc/gpt_neox_japanese.md
index d4bd3276e0..c21ba83879 100644
--- a/docs/source/en/model_doc/gpt_neox_japanese.mdx
+++ b/docs/source/en/model_doc/gpt_neox_japanese.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # GPT-NeoX-Japanese
diff --git a/docs/source/en/model_doc/gptj.mdx b/docs/source/en/model_doc/gptj.md
similarity index 97%
rename from docs/source/en/model_doc/gptj.mdx
rename to docs/source/en/model_doc/gptj.md
index b972513326..5ad80a0109 100644
--- a/docs/source/en/model_doc/gptj.mdx
+++ b/docs/source/en/model_doc/gptj.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # GPT-J
diff --git a/docs/source/en/model_doc/gptsan-japanese.mdx b/docs/source/en/model_doc/gptsan-japanese.md
similarity index 96%
rename from docs/source/en/model_doc/gptsan-japanese.mdx
rename to docs/source/en/model_doc/gptsan-japanese.md
index aa06cb73b5..48f67f8506 100644
--- a/docs/source/en/model_doc/gptsan-japanese.mdx
+++ b/docs/source/en/model_doc/gptsan-japanese.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # GPTSAN-japanese
diff --git a/docs/source/en/model_doc/graphormer.mdx b/docs/source/en/model_doc/graphormer.md
similarity index 94%
rename from docs/source/en/model_doc/graphormer.mdx
rename to docs/source/en/model_doc/graphormer.md
index cfa8e30dcf..16d61bccbe 100644
--- a/docs/source/en/model_doc/graphormer.mdx
+++ b/docs/source/en/model_doc/graphormer.md
@@ -6,6 +6,10 @@ the License.
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # Graphormer
diff --git a/docs/source/en/model_doc/groupvit.mdx b/docs/source/en/model_doc/groupvit.md
similarity index 95%
rename from docs/source/en/model_doc/groupvit.mdx
rename to docs/source/en/model_doc/groupvit.md
index 200ec7ccb8..cf006e284b 100644
--- a/docs/source/en/model_doc/groupvit.mdx
+++ b/docs/source/en/model_doc/groupvit.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # GroupViT
diff --git a/docs/source/en/model_doc/herbert.mdx b/docs/source/en/model_doc/herbert.md
similarity index 95%
rename from docs/source/en/model_doc/herbert.mdx
rename to docs/source/en/model_doc/herbert.md
index 90e08ebe9a..ee927bddb0 100644
--- a/docs/source/en/model_doc/herbert.mdx
+++ b/docs/source/en/model_doc/herbert.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # HerBERT
diff --git a/docs/source/en/model_doc/hubert.mdx b/docs/source/en/model_doc/hubert.md
similarity index 94%
rename from docs/source/en/model_doc/hubert.mdx
rename to docs/source/en/model_doc/hubert.md
index 0fcf939395..5349e13885 100644
--- a/docs/source/en/model_doc/hubert.mdx
+++ b/docs/source/en/model_doc/hubert.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # Hubert
diff --git a/docs/source/en/model_doc/ibert.mdx b/docs/source/en/model_doc/ibert.md
similarity index 95%
rename from docs/source/en/model_doc/ibert.mdx
rename to docs/source/en/model_doc/ibert.md
index 90735832c8..9c5f9c3e8d 100644
--- a/docs/source/en/model_doc/ibert.mdx
+++ b/docs/source/en/model_doc/ibert.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # I-BERT
diff --git a/docs/source/en/model_doc/imagegpt.mdx b/docs/source/en/model_doc/imagegpt.md
similarity index 97%
rename from docs/source/en/model_doc/imagegpt.mdx
rename to docs/source/en/model_doc/imagegpt.md
index 13b03560b8..01eb7dde5f 100644
--- a/docs/source/en/model_doc/imagegpt.mdx
+++ b/docs/source/en/model_doc/imagegpt.md
@@ -7,6 +7,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an
 "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 specific language governing permissions and limitations under the License. -->
 
 # ImageGPT
diff --git a/docs/source/en/model_doc/informer.mdx b/docs/source/en/model_doc/informer.md
similarity index 95%
rename from docs/source/en/model_doc/informer.mdx
rename to docs/source/en/model_doc/informer.md
index 7631e532c4..4ab48f6f82 100644
--- a/docs/source/en/model_doc/informer.mdx
+++ b/docs/source/en/model_doc/informer.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # Informer
diff --git a/docs/source/en/model_doc/jukebox.mdx b/docs/source/en/model_doc/jukebox.md
similarity index 96%
rename from docs/source/en/model_doc/jukebox.mdx
rename to docs/source/en/model_doc/jukebox.md
index 5ecd71ea36..5dc87ab6de 100644
--- a/docs/source/en/model_doc/jukebox.mdx
+++ b/docs/source/en/model_doc/jukebox.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 # Jukebox
 
diff --git a/docs/source/en/model_doc/layoutlm.mdx b/docs/source/en/model_doc/layoutlm.md
similarity index 97%
rename from docs/source/en/model_doc/layoutlm.mdx
rename to docs/source/en/model_doc/layoutlm.md
index f9e34922f6..ebf6b1a4b4 100644
--- a/docs/source/en/model_doc/layoutlm.mdx
+++ b/docs/source/en/model_doc/layoutlm.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # LayoutLM
diff --git a/docs/source/en/model_doc/layoutlmv2.mdx b/docs/source/en/model_doc/layoutlmv2.md
similarity index 99%
rename from docs/source/en/model_doc/layoutlmv2.mdx
rename to docs/source/en/model_doc/layoutlmv2.md
index 6d2a9dc3bb..37d1c1671e 100644
--- a/docs/source/en/model_doc/layoutlmv2.mdx
+++ b/docs/source/en/model_doc/layoutlmv2.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # LayoutLMV2
diff --git a/docs/source/en/model_doc/layoutlmv3.mdx b/docs/source/en/model_doc/layoutlmv3.md
similarity index 97%
rename from docs/source/en/model_doc/layoutlmv3.mdx
rename to docs/source/en/model_doc/layoutlmv3.md
index 2a8299a413..39408ab88a 100644
--- a/docs/source/en/model_doc/layoutlmv3.mdx
+++ b/docs/source/en/model_doc/layoutlmv3.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # LayoutLMv3
diff --git a/docs/source/en/model_doc/layoutxlm.mdx b/docs/source/en/model_doc/layoutxlm.md
similarity index 95%
rename from docs/source/en/model_doc/layoutxlm.mdx
rename to docs/source/en/model_doc/layoutxlm.md
index ed112453be..20f9ffd603 100644
--- a/docs/source/en/model_doc/layoutxlm.mdx
+++ b/docs/source/en/model_doc/layoutxlm.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # LayoutXLM
diff --git a/docs/source/en/model_doc/led.mdx b/docs/source/en/model_doc/led.md
similarity index 96%
rename from docs/source/en/model_doc/led.mdx
rename to docs/source/en/model_doc/led.md
index 537cfba528..9ba9383a59 100644
--- a/docs/source/en/model_doc/led.mdx
+++ b/docs/source/en/model_doc/led.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # LED
diff --git a/docs/source/en/model_doc/levit.mdx b/docs/source/en/model_doc/levit.md
similarity index 97%
rename from docs/source/en/model_doc/levit.mdx
rename to docs/source/en/model_doc/levit.md
index bfca2a5c06..8145be775f 100644
--- a/docs/source/en/model_doc/levit.mdx
+++ b/docs/source/en/model_doc/levit.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # LeViT
diff --git a/docs/source/en/model_doc/lilt.mdx b/docs/source/en/model_doc/lilt.md
similarity index 96%
rename from docs/source/en/model_doc/lilt.mdx
rename to docs/source/en/model_doc/lilt.md
index 421bc066d1..901deefd7f 100644
--- a/docs/source/en/model_doc/lilt.mdx
+++ b/docs/source/en/model_doc/lilt.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # LiLT
diff --git a/docs/source/en/model_doc/llama.mdx b/docs/source/en/model_doc/llama.md
similarity index 96%
rename from docs/source/en/model_doc/llama.mdx
rename to docs/source/en/model_doc/llama.md
index 5a107eaa84..01b3e28d21 100644
--- a/docs/source/en/model_doc/llama.mdx
+++ b/docs/source/en/model_doc/llama.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # LLaMA
diff --git a/docs/source/en/model_doc/longformer.mdx b/docs/source/en/model_doc/longformer.md
similarity index 97%
rename from docs/source/en/model_doc/longformer.mdx
rename to docs/source/en/model_doc/longformer.md
index 8170992624..9947195058 100644
--- a/docs/source/en/model_doc/longformer.mdx
+++ b/docs/source/en/model_doc/longformer.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # Longformer
diff --git a/docs/source/en/model_doc/longt5.mdx b/docs/source/en/model_doc/longt5.md
similarity index 97%
rename from docs/source/en/model_doc/longt5.mdx
rename to docs/source/en/model_doc/longt5.md
index 9ae3d29a21..e8dcfe3b23 100644
--- a/docs/source/en/model_doc/longt5.mdx
+++ b/docs/source/en/model_doc/longt5.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # LongT5
diff --git a/docs/source/en/model_doc/luke.mdx b/docs/source/en/model_doc/luke.md
similarity index 98%
rename from docs/source/en/model_doc/luke.mdx
rename to docs/source/en/model_doc/luke.md
index c96c098eb0..2947c7c41b 100644
--- a/docs/source/en/model_doc/luke.mdx
+++ b/docs/source/en/model_doc/luke.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # LUKE
diff --git a/docs/source/en/model_doc/lxmert.mdx b/docs/source/en/model_doc/lxmert.md
similarity index 96%
rename from docs/source/en/model_doc/lxmert.mdx
rename to docs/source/en/model_doc/lxmert.md
index 083a98c34c..114539f61e 100644
--- a/docs/source/en/model_doc/lxmert.mdx
+++ b/docs/source/en/model_doc/lxmert.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # LXMERT
diff --git a/docs/source/en/model_doc/m2m_100.mdx b/docs/source/en/model_doc/m2m_100.md
similarity index 97%
rename from docs/source/en/model_doc/m2m_100.mdx
rename to docs/source/en/model_doc/m2m_100.md
index ebe49d5780..c2b4354c6d 100644
--- a/docs/source/en/model_doc/m2m_100.mdx
+++ b/docs/source/en/model_doc/m2m_100.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # M2M100
diff --git a/docs/source/en/model_doc/marian.mdx b/docs/source/en/model_doc/marian.md
similarity index 98%
rename from docs/source/en/model_doc/marian.mdx
rename to docs/source/en/model_doc/marian.md
index dbca456978..8be4168659 100644
--- a/docs/source/en/model_doc/marian.mdx
+++ b/docs/source/en/model_doc/marian.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # MarianMT
diff --git a/docs/source/en/model_doc/markuplm.mdx b/docs/source/en/model_doc/markuplm.md
similarity index 98%
rename from docs/source/en/model_doc/markuplm.mdx
rename to docs/source/en/model_doc/markuplm.md
index ef8d52ab25..b286c4fc00 100644
--- a/docs/source/en/model_doc/markuplm.mdx
+++ b/docs/source/en/model_doc/markuplm.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # MarkupLM
diff --git a/docs/source/en/model_doc/mask2former.mdx b/docs/source/en/model_doc/mask2former.md
similarity index 96%
rename from docs/source/en/model_doc/mask2former.mdx
rename to docs/source/en/model_doc/mask2former.md
index f0d43ba78f..ddfa5da2ba 100644
--- a/docs/source/en/model_doc/mask2former.mdx
+++ b/docs/source/en/model_doc/mask2former.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # Mask2Former
diff --git a/docs/source/en/model_doc/maskformer.mdx b/docs/source/en/model_doc/maskformer.md
similarity index 96%
rename from docs/source/en/model_doc/maskformer.mdx
rename to docs/source/en/model_doc/maskformer.md
index 5620c803bf..4695e54857 100644
--- a/docs/source/en/model_doc/maskformer.mdx
+++ b/docs/source/en/model_doc/maskformer.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # MaskFormer
diff --git a/docs/source/en/model_doc/matcha.mdx b/docs/source/en/model_doc/matcha.md
similarity index 96%
rename from docs/source/en/model_doc/matcha.mdx
rename to docs/source/en/model_doc/matcha.md
index 5087157273..20c403413f 100644
--- a/docs/source/en/model_doc/matcha.mdx
+++ b/docs/source/en/model_doc/matcha.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # MatCha
diff --git a/docs/source/en/model_doc/mbart.mdx b/docs/source/en/model_doc/mbart.md
similarity index 98%
rename from docs/source/en/model_doc/mbart.mdx
rename to docs/source/en/model_doc/mbart.md
index ed9f1f5cfd..8a614dd505 100644
--- a/docs/source/en/model_doc/mbart.mdx
+++ b/docs/source/en/model_doc/mbart.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # MBart and MBart-50
diff --git a/docs/source/en/model_doc/mctct.mdx b/docs/source/en/model_doc/mctct.md
similarity index 94%
rename from docs/source/en/model_doc/mctct.mdx
rename to docs/source/en/model_doc/mctct.md
index 89952a82fb..1fbe78dca6 100644
--- a/docs/source/en/model_doc/mctct.mdx
+++ b/docs/source/en/model_doc/mctct.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # M-CTC-T
diff --git a/docs/source/en/model_doc/mega.mdx b/docs/source/en/model_doc/mega.md
similarity index 96%
rename from docs/source/en/model_doc/mega.mdx
rename to docs/source/en/model_doc/mega.md
index 2a6fa1e330..d4d68b9bec 100644
--- a/docs/source/en/model_doc/mega.mdx
+++ b/docs/source/en/model_doc/mega.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # MEGA
diff --git a/docs/source/en/model_doc/megatron-bert.mdx b/docs/source/en/model_doc/megatron-bert.md
similarity index 97%
rename from docs/source/en/model_doc/megatron-bert.mdx
rename to docs/source/en/model_doc/megatron-bert.md
index 9fe5db6c7a..88ccff2358 100644
--- a/docs/source/en/model_doc/megatron-bert.mdx
+++ b/docs/source/en/model_doc/megatron-bert.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # MegatronBERT
diff --git a/docs/source/en/model_doc/megatron_gpt2.mdx b/docs/source/en/model_doc/megatron_gpt2.md
similarity index 96%
rename from docs/source/en/model_doc/megatron_gpt2.mdx
rename to docs/source/en/model_doc/megatron_gpt2.md
index a0d91e5a16..1eea7d82bf 100644
--- a/docs/source/en/model_doc/megatron_gpt2.mdx
+++ b/docs/source/en/model_doc/megatron_gpt2.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # MegatronGPT2
diff --git a/docs/source/en/model_doc/mgp-str.mdx b/docs/source/en/model_doc/mgp-str.md
similarity index 96%
rename from docs/source/en/model_doc/mgp-str.mdx
rename to docs/source/en/model_doc/mgp-str.md
index 77c937bfb2..e384c06201 100644
--- a/docs/source/en/model_doc/mgp-str.mdx
+++ b/docs/source/en/model_doc/mgp-str.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # MGP-STR
diff --git a/docs/source/en/model_doc/mluke.mdx b/docs/source/en/model_doc/mluke.md
similarity index 94%
rename from docs/source/en/model_doc/mluke.mdx
rename to docs/source/en/model_doc/mluke.md
index b910f17ae2..ec9430848c 100644
--- a/docs/source/en/model_doc/mluke.mdx
+++ b/docs/source/en/model_doc/mluke.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # mLUKE
diff --git a/docs/source/en/model_doc/mms.mdx b/docs/source/en/model_doc/mms.md
similarity index 98%
rename from docs/source/en/model_doc/mms.mdx
rename to docs/source/en/model_doc/mms.md
index eaf524b372..4f3cc93e53 100644
--- a/docs/source/en/model_doc/mms.mdx
+++ b/docs/source/en/model_doc/mms.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # MMS
diff --git a/docs/source/en/model_doc/mobilebert.mdx b/docs/source/en/model_doc/mobilebert.md
similarity index 96%
rename from docs/source/en/model_doc/mobilebert.mdx
rename to docs/source/en/model_doc/mobilebert.md
index 9f6d6c6af0..e652756351 100644
--- a/docs/source/en/model_doc/mobilebert.mdx
+++ b/docs/source/en/model_doc/mobilebert.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # MobileBERT
diff --git a/docs/source/en/model_doc/mobilenet_v1.mdx b/docs/source/en/model_doc/mobilenet_v1.md
similarity index 96%
rename from docs/source/en/model_doc/mobilenet_v1.mdx
rename to docs/source/en/model_doc/mobilenet_v1.md
index 6a9fff2765..56743efe14 100644
--- a/docs/source/en/model_doc/mobilenet_v1.mdx
+++ b/docs/source/en/model_doc/mobilenet_v1.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # MobileNet V1
diff --git a/docs/source/en/model_doc/mobilenet_v2.mdx b/docs/source/en/model_doc/mobilenet_v2.md
similarity index 97%
rename from docs/source/en/model_doc/mobilenet_v2.mdx
rename to docs/source/en/model_doc/mobilenet_v2.md
index d4d6856a91..bd4114dc71 100644
--- a/docs/source/en/model_doc/mobilenet_v2.mdx
+++ b/docs/source/en/model_doc/mobilenet_v2.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # MobileNet V2
diff --git a/docs/source/en/model_doc/mobilevit.mdx b/docs/source/en/model_doc/mobilevit.md
similarity index 97%
rename from docs/source/en/model_doc/mobilevit.mdx
rename to docs/source/en/model_doc/mobilevit.md
index c100697145..2d81579568 100644
--- a/docs/source/en/model_doc/mobilevit.mdx
+++ b/docs/source/en/model_doc/mobilevit.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # MobileViT
diff --git a/docs/source/en/model_doc/mobilevitv2.mdx b/docs/source/en/model_doc/mobilevitv2.md
similarity index 95%
rename from docs/source/en/model_doc/mobilevitv2.mdx
rename to docs/source/en/model_doc/mobilevitv2.md
index 1cfbb6808a..4b6689ef2b 100644
--- a/docs/source/en/model_doc/mobilevitv2.mdx
+++ b/docs/source/en/model_doc/mobilevitv2.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # MobileViTV2
diff --git a/docs/source/en/model_doc/mpnet.mdx b/docs/source/en/model_doc/mpnet.md
similarity index 96%
rename from docs/source/en/model_doc/mpnet.mdx
rename to docs/source/en/model_doc/mpnet.md
index cf8b4de7a6..97c140f631 100644
--- a/docs/source/en/model_doc/mpnet.mdx
+++ b/docs/source/en/model_doc/mpnet.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # MPNet
diff --git a/docs/source/en/model_doc/mt5.mdx b/docs/source/en/model_doc/mt5.md
similarity index 95%
rename from docs/source/en/model_doc/mt5.mdx
rename to docs/source/en/model_doc/mt5.md
index 9de91982ac..1e769f5ac1 100644
--- a/docs/source/en/model_doc/mt5.mdx
+++ b/docs/source/en/model_doc/mt5.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # mT5
diff --git a/docs/source/en/model_doc/mvp.mdx b/docs/source/en/model_doc/mvp.md
similarity index 97%
rename from docs/source/en/model_doc/mvp.mdx
rename to docs/source/en/model_doc/mvp.md
index d457212e6c..043163f40b 100644
--- a/docs/source/en/model_doc/mvp.mdx
+++ b/docs/source/en/model_doc/mvp.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # MVP
diff --git a/docs/source/en/model_doc/nat.mdx b/docs/source/en/model_doc/nat.md
similarity index 96%
rename from docs/source/en/model_doc/nat.mdx
rename to docs/source/en/model_doc/nat.md
index 5487dbee0c..668951c241 100644
--- a/docs/source/en/model_doc/nat.mdx
+++ b/docs/source/en/model_doc/nat.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # Neighborhood Attention Transformer
diff --git a/docs/source/en/model_doc/nezha.mdx b/docs/source/en/model_doc/nezha.md
similarity index 94%
rename from docs/source/en/model_doc/nezha.mdx
rename to docs/source/en/model_doc/nezha.md
index 3d6baf5d8a..9c136cdf06 100644
--- a/docs/source/en/model_doc/nezha.mdx
+++ b/docs/source/en/model_doc/nezha.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # Nezha
diff --git a/docs/source/en/model_doc/nllb-moe.mdx b/docs/source/en/model_doc/nllb-moe.md
similarity index 97%
rename from docs/source/en/model_doc/nllb-moe.mdx
rename to docs/source/en/model_doc/nllb-moe.md
index eae0b644e9..4688e67ef4 100644
--- a/docs/source/en/model_doc/nllb-moe.mdx
+++ b/docs/source/en/model_doc/nllb-moe.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # NLLB-MOE
diff --git a/docs/source/en/model_doc/nllb.mdx b/docs/source/en/model_doc/nllb.md
similarity index 97%
rename from docs/source/en/model_doc/nllb.mdx
rename to docs/source/en/model_doc/nllb.md
index 60819da998..ec50716c73 100644
--- a/docs/source/en/model_doc/nllb.mdx
+++ b/docs/source/en/model_doc/nllb.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # NLLB
diff --git a/docs/source/en/model_doc/nystromformer.mdx b/docs/source/en/model_doc/nystromformer.md
similarity index 95%
rename from docs/source/en/model_doc/nystromformer.mdx
rename to docs/source/en/model_doc/nystromformer.md
index 1e6d1b2121..6434944aba 100644
--- a/docs/source/en/model_doc/nystromformer.mdx
+++ b/docs/source/en/model_doc/nystromformer.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # Nyströmformer
diff --git a/docs/source/en/model_doc/oneformer.mdx b/docs/source/en/model_doc/oneformer.md
similarity index 97%
rename from docs/source/en/model_doc/oneformer.mdx
rename to docs/source/en/model_doc/oneformer.md
index 3560d84bc7..5f8f46e152 100644
--- a/docs/source/en/model_doc/oneformer.mdx
+++ b/docs/source/en/model_doc/oneformer.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # OneFormer
diff --git a/docs/source/en/model_doc/open-llama.mdx b/docs/source/en/model_doc/open-llama.md
similarity index 90%
rename from docs/source/en/model_doc/open-llama.mdx
rename to docs/source/en/model_doc/open-llama.md
index fa463953ee..23d35b8057 100644
--- a/docs/source/en/model_doc/open-llama.mdx
+++ b/docs/source/en/model_doc/open-llama.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # Open-Llama
diff --git a/docs/source/en/model_doc/openai-gpt.mdx b/docs/source/en/model_doc/openai-gpt.md
similarity index 97%
rename from docs/source/en/model_doc/openai-gpt.mdx
rename to docs/source/en/model_doc/openai-gpt.md
index 5c1b935ea9..ff98930b57 100644
--- a/docs/source/en/model_doc/openai-gpt.mdx
+++ b/docs/source/en/model_doc/openai-gpt.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # OpenAI GPT
diff --git a/docs/source/en/model_doc/opt.mdx b/docs/source/en/model_doc/opt.md
similarity index 95%
rename from docs/source/en/model_doc/opt.mdx
rename to docs/source/en/model_doc/opt.md
index 073c7c3bfc..332c63600a 100644
--- a/docs/source/en/model_doc/opt.mdx
+++ b/docs/source/en/model_doc/opt.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # OPT
@@ -45,7 +49,7 @@ The resource should ideally demonstrate something new instead of duplicating an
 
 <PipelineTag pipeline="text-classification" />
 
-- [Text classification task guide](sequence_classification.mdx)
+- [Text classification task guide](sequence_classification.md)
 - [`OPTForSequenceClassification`] is supported by this [example script](https://github.com/huggingface/transformers/tree/main/examples/pytorch/text-classification) and [notebook](https://colab.research.google.com/github/huggingface/notebooks/blob/main/examples/text_classification.ipynb).
 
 <PipelineTag pipeline="question-answering" />
diff --git a/docs/source/en/model_doc/owlvit.mdx b/docs/source/en/model_doc/owlvit.md
similarity index 97%
rename from docs/source/en/model_doc/owlvit.mdx
rename to docs/source/en/model_doc/owlvit.md
index f13ad4a540..59a4aa0bc3 100644
--- a/docs/source/en/model_doc/owlvit.mdx
+++ b/docs/source/en/model_doc/owlvit.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # OWL-ViT
diff --git a/docs/source/en/model_doc/pegasus.mdx b/docs/source/en/model_doc/pegasus.md
similarity index 97%
rename from docs/source/en/model_doc/pegasus.mdx
rename to docs/source/en/model_doc/pegasus.md
index 41919a7e3c..14608aae31 100644
--- a/docs/source/en/model_doc/pegasus.mdx
+++ b/docs/source/en/model_doc/pegasus.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # Pegasus
diff --git a/docs/source/en/model_doc/pegasus_x.mdx b/docs/source/en/model_doc/pegasus_x.md
similarity index 94%
rename from docs/source/en/model_doc/pegasus_x.mdx
rename to docs/source/en/model_doc/pegasus_x.md
index 12e579a054..a0fd670fc7 100644
--- a/docs/source/en/model_doc/pegasus_x.mdx
+++ b/docs/source/en/model_doc/pegasus_x.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # PEGASUS-X
diff --git a/docs/source/en/model_doc/perceiver.mdx b/docs/source/en/model_doc/perceiver.md
similarity index 98%
rename from docs/source/en/model_doc/perceiver.mdx
rename to docs/source/en/model_doc/perceiver.md
index 42297b22ce..97921baed2 100644
--- a/docs/source/en/model_doc/perceiver.mdx
+++ b/docs/source/en/model_doc/perceiver.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # Perceiver
diff --git a/docs/source/en/model_doc/phobert.mdx b/docs/source/en/model_doc/phobert.md
similarity index 92%
rename from docs/source/en/model_doc/phobert.mdx
rename to docs/source/en/model_doc/phobert.md
index 4ae9b0aa62..5543a9b354 100644
--- a/docs/source/en/model_doc/phobert.mdx
+++ b/docs/source/en/model_doc/phobert.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # PhoBERT
diff --git a/docs/source/en/model_doc/pix2struct.mdx b/docs/source/en/model_doc/pix2struct.md
similarity index 96%
rename from docs/source/en/model_doc/pix2struct.mdx
rename to docs/source/en/model_doc/pix2struct.md
index f4ead88f5c..b722a59b82 100644
--- a/docs/source/en/model_doc/pix2struct.mdx
+++ b/docs/source/en/model_doc/pix2struct.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # Pix2Struct
diff --git a/docs/source/en/model_doc/plbart.mdx b/docs/source/en/model_doc/plbart.md
similarity index 97%
rename from docs/source/en/model_doc/plbart.mdx
rename to docs/source/en/model_doc/plbart.md
index bca1a5426c..c9f5020214 100644
--- a/docs/source/en/model_doc/plbart.mdx
+++ b/docs/source/en/model_doc/plbart.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # PLBart
diff --git a/docs/source/en/model_doc/poolformer.mdx b/docs/source/en/model_doc/poolformer.md
similarity index 96%
rename from docs/source/en/model_doc/poolformer.mdx
rename to docs/source/en/model_doc/poolformer.md
index bec2fdc23b..537c60bdbc 100644
--- a/docs/source/en/model_doc/poolformer.mdx
+++ b/docs/source/en/model_doc/poolformer.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # PoolFormer
diff --git a/docs/source/en/model_doc/prophetnet.mdx b/docs/source/en/model_doc/prophetnet.md
similarity index 96%
rename from docs/source/en/model_doc/prophetnet.mdx
rename to docs/source/en/model_doc/prophetnet.md
index 071bdfbadf..6ab0937da7 100644
--- a/docs/source/en/model_doc/prophetnet.mdx
+++ b/docs/source/en/model_doc/prophetnet.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # ProphetNet
diff --git a/docs/source/en/model_doc/qdqbert.mdx b/docs/source/en/model_doc/qdqbert.md
similarity index 97%
rename from docs/source/en/model_doc/qdqbert.mdx
rename to docs/source/en/model_doc/qdqbert.md
index 3a65bd26c3..62a0e01084 100644
--- a/docs/source/en/model_doc/qdqbert.mdx
+++ b/docs/source/en/model_doc/qdqbert.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # QDQBERT
diff --git a/docs/source/en/model_doc/rag.mdx b/docs/source/en/model_doc/rag.md
similarity index 96%
rename from docs/source/en/model_doc/rag.mdx
rename to docs/source/en/model_doc/rag.md
index f1cf9e4bc2..b467c6169f 100644
--- a/docs/source/en/model_doc/rag.mdx
+++ b/docs/source/en/model_doc/rag.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # RAG
diff --git a/docs/source/en/model_doc/realm.mdx b/docs/source/en/model_doc/realm.md
similarity index 95%
rename from docs/source/en/model_doc/realm.mdx
rename to docs/source/en/model_doc/realm.md
index 545b1e0a3b..a8227bc83c 100644
--- a/docs/source/en/model_doc/realm.mdx
+++ b/docs/source/en/model_doc/realm.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # REALM
diff --git a/docs/source/en/model_doc/reformer.mdx b/docs/source/en/model_doc/reformer.md
similarity index 98%
rename from docs/source/en/model_doc/reformer.mdx
rename to docs/source/en/model_doc/reformer.md
index 6725173d54..05274c7667 100644
--- a/docs/source/en/model_doc/reformer.mdx
+++ b/docs/source/en/model_doc/reformer.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # Reformer
diff --git a/docs/source/en/model_doc/regnet.mdx b/docs/source/en/model_doc/regnet.md
similarity index 96%
rename from docs/source/en/model_doc/regnet.mdx
rename to docs/source/en/model_doc/regnet.md
index ac94b5b172..89e89459bd 100644
--- a/docs/source/en/model_doc/regnet.mdx
+++ b/docs/source/en/model_doc/regnet.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # RegNet
diff --git a/docs/source/en/model_doc/rembert.mdx b/docs/source/en/model_doc/rembert.md
similarity index 96%
rename from docs/source/en/model_doc/rembert.mdx
rename to docs/source/en/model_doc/rembert.md
index 2a17a9b384..b2e4d0f5ad 100644
--- a/docs/source/en/model_doc/rembert.mdx
+++ b/docs/source/en/model_doc/rembert.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # RemBERT
diff --git a/docs/source/en/model_doc/resnet.mdx b/docs/source/en/model_doc/resnet.md
similarity index 96%
rename from docs/source/en/model_doc/resnet.mdx
rename to docs/source/en/model_doc/resnet.md
index a34596bdd6..9bb36a776f 100644
--- a/docs/source/en/model_doc/resnet.mdx
+++ b/docs/source/en/model_doc/resnet.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # ResNet
diff --git a/docs/source/en/model_doc/retribert.mdx b/docs/source/en/model_doc/retribert.md
similarity index 89%
rename from docs/source/en/model_doc/retribert.mdx
rename to docs/source/en/model_doc/retribert.md
index e83fae3230..d982cf4a0b 100644
--- a/docs/source/en/model_doc/retribert.mdx
+++ b/docs/source/en/model_doc/retribert.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # RetriBERT
diff --git a/docs/source/en/model_doc/roberta-prelayernorm.mdx b/docs/source/en/model_doc/roberta-prelayernorm.md
similarity index 96%
rename from docs/source/en/model_doc/roberta-prelayernorm.mdx
rename to docs/source/en/model_doc/roberta-prelayernorm.md
index 41b0762de7..9822fd7af9 100644
--- a/docs/source/en/model_doc/roberta-prelayernorm.mdx
+++ b/docs/source/en/model_doc/roberta-prelayernorm.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # RoBERTa-PreLayerNorm
diff --git a/docs/source/en/model_doc/roberta.mdx b/docs/source/en/model_doc/roberta.md
similarity index 98%
rename from docs/source/en/model_doc/roberta.mdx
rename to docs/source/en/model_doc/roberta.md
index 49007409ad..5a2ba6b5cf 100644
--- a/docs/source/en/model_doc/roberta.mdx
+++ b/docs/source/en/model_doc/roberta.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # RoBERTa
diff --git a/docs/source/en/model_doc/roc_bert.mdx b/docs/source/en/model_doc/roc_bert.md
similarity index 95%
rename from docs/source/en/model_doc/roc_bert.mdx
rename to docs/source/en/model_doc/roc_bert.md
index 50d123261e..831c656fb8 100644
--- a/docs/source/en/model_doc/roc_bert.mdx
+++ b/docs/source/en/model_doc/roc_bert.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # RoCBert
diff --git a/docs/source/en/model_doc/roformer.mdx b/docs/source/en/model_doc/roformer.md
similarity index 96%
rename from docs/source/en/model_doc/roformer.mdx
rename to docs/source/en/model_doc/roformer.md
index 942ca9ec53..f15a106296 100644
--- a/docs/source/en/model_doc/roformer.mdx
+++ b/docs/source/en/model_doc/roformer.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # RoFormer
diff --git a/docs/source/en/model_doc/rwkv.mdx b/docs/source/en/model_doc/rwkv.md
similarity index 97%
rename from docs/source/en/model_doc/rwkv.mdx
rename to docs/source/en/model_doc/rwkv.md
index b881251656..cde8218bd0 100644
--- a/docs/source/en/model_doc/rwkv.mdx
+++ b/docs/source/en/model_doc/rwkv.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # RWKV
diff --git a/docs/source/en/model_doc/sam.mdx b/docs/source/en/model_doc/sam.md
similarity index 96%
rename from docs/source/en/model_doc/sam.mdx
rename to docs/source/en/model_doc/sam.md
index ac8aa4a573..fe0d24623f 100644
--- a/docs/source/en/model_doc/sam.mdx
+++ b/docs/source/en/model_doc/sam.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # SAM
diff --git a/docs/source/en/model_doc/segformer.mdx b/docs/source/en/model_doc/segformer.md
similarity index 98%
rename from docs/source/en/model_doc/segformer.mdx
rename to docs/source/en/model_doc/segformer.md
index 1734a20195..0f535351af 100644
--- a/docs/source/en/model_doc/segformer.mdx
+++ b/docs/source/en/model_doc/segformer.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # SegFormer
diff --git a/docs/source/en/model_doc/sew-d.mdx b/docs/source/en/model_doc/sew-d.md
similarity index 93%
rename from docs/source/en/model_doc/sew-d.mdx
rename to docs/source/en/model_doc/sew-d.md
index 1141be6857..b70c59061b 100644
--- a/docs/source/en/model_doc/sew-d.mdx
+++ b/docs/source/en/model_doc/sew-d.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # SEW-D
diff --git a/docs/source/en/model_doc/sew.mdx b/docs/source/en/model_doc/sew.md
similarity index 93%
rename from docs/source/en/model_doc/sew.mdx
rename to docs/source/en/model_doc/sew.md
index a4a780e992..ebf128ea42 100644
--- a/docs/source/en/model_doc/sew.mdx
+++ b/docs/source/en/model_doc/sew.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # SEW
diff --git a/docs/source/en/model_doc/speech-encoder-decoder.mdx b/docs/source/en/model_doc/speech-encoder-decoder.md
similarity index 97%
rename from docs/source/en/model_doc/speech-encoder-decoder.mdx
rename to docs/source/en/model_doc/speech-encoder-decoder.md
index b0718a27a8..495f7da659 100644
--- a/docs/source/en/model_doc/speech-encoder-decoder.mdx
+++ b/docs/source/en/model_doc/speech-encoder-decoder.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # Speech Encoder Decoder Models
diff --git a/docs/source/en/model_doc/speech_to_text.mdx b/docs/source/en/model_doc/speech_to_text.md
similarity index 97%
rename from docs/source/en/model_doc/speech_to_text.mdx
rename to docs/source/en/model_doc/speech_to_text.md
index 95efc5504f..cb13a1871a 100644
--- a/docs/source/en/model_doc/speech_to_text.mdx
+++ b/docs/source/en/model_doc/speech_to_text.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # Speech2Text
diff --git a/docs/source/en/model_doc/speech_to_text_2.mdx b/docs/source/en/model_doc/speech_to_text_2.md
similarity index 96%
rename from docs/source/en/model_doc/speech_to_text_2.mdx
rename to docs/source/en/model_doc/speech_to_text_2.md
index 745102c30b..1abdeced58 100644
--- a/docs/source/en/model_doc/speech_to_text_2.mdx
+++ b/docs/source/en/model_doc/speech_to_text_2.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # Speech2Text2
diff --git a/docs/source/en/model_doc/speecht5.mdx b/docs/source/en/model_doc/speecht5.md
similarity index 95%
rename from docs/source/en/model_doc/speecht5.mdx
rename to docs/source/en/model_doc/speecht5.md
index 848744b24d..915fe2a9c4 100644
--- a/docs/source/en/model_doc/speecht5.mdx
+++ b/docs/source/en/model_doc/speecht5.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # SpeechT5
diff --git a/docs/source/en/model_doc/splinter.mdx b/docs/source/en/model_doc/splinter.md
similarity index 96%
rename from docs/source/en/model_doc/splinter.mdx
rename to docs/source/en/model_doc/splinter.md
index 6c89ac6fe7..f16169d9b2 100644
--- a/docs/source/en/model_doc/splinter.mdx
+++ b/docs/source/en/model_doc/splinter.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # Splinter
diff --git a/docs/source/en/model_doc/squeezebert.mdx b/docs/source/en/model_doc/squeezebert.md
similarity index 96%
rename from docs/source/en/model_doc/squeezebert.mdx
rename to docs/source/en/model_doc/squeezebert.md
index a5f443f9a9..515a2ef317 100644
--- a/docs/source/en/model_doc/squeezebert.mdx
+++ b/docs/source/en/model_doc/squeezebert.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # SqueezeBERT
diff --git a/docs/source/en/model_doc/swiftformer.mdx b/docs/source/en/model_doc/swiftformer.md
similarity index 95%
rename from docs/source/en/model_doc/swiftformer.mdx
rename to docs/source/en/model_doc/swiftformer.md
index 29ca6e2294..67c9597d21 100644
--- a/docs/source/en/model_doc/swiftformer.mdx
+++ b/docs/source/en/model_doc/swiftformer.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # SwiftFormer
diff --git a/docs/source/en/model_doc/swin.mdx b/docs/source/en/model_doc/swin.md
similarity index 96%
rename from docs/source/en/model_doc/swin.mdx
rename to docs/source/en/model_doc/swin.md
index 5f1cf1bfd0..37bb86db95 100644
--- a/docs/source/en/model_doc/swin.mdx
+++ b/docs/source/en/model_doc/swin.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # Swin Transformer
diff --git a/docs/source/en/model_doc/swin2sr.mdx b/docs/source/en/model_doc/swin2sr.md
similarity index 95%
rename from docs/source/en/model_doc/swin2sr.mdx
rename to docs/source/en/model_doc/swin2sr.md
index edb073d1ee..dfee144e50 100644
--- a/docs/source/en/model_doc/swin2sr.mdx
+++ b/docs/source/en/model_doc/swin2sr.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # Swin2SR
diff --git a/docs/source/en/model_doc/swinv2.mdx b/docs/source/en/model_doc/swinv2.md
similarity index 95%
rename from docs/source/en/model_doc/swinv2.mdx
rename to docs/source/en/model_doc/swinv2.md
index 02ff62c685..e08389527e 100644
--- a/docs/source/en/model_doc/swinv2.mdx
+++ b/docs/source/en/model_doc/swinv2.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # Swin Transformer V2
diff --git a/docs/source/en/model_doc/switch_transformers.mdx b/docs/source/en/model_doc/switch_transformers.md
similarity index 96%
rename from docs/source/en/model_doc/switch_transformers.mdx
rename to docs/source/en/model_doc/switch_transformers.md
index 679863d264..8f6a231b7e 100644
--- a/docs/source/en/model_doc/switch_transformers.mdx
+++ b/docs/source/en/model_doc/switch_transformers.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # SwitchTransformers
diff --git a/docs/source/en/model_doc/t5.mdx b/docs/source/en/model_doc/t5.md
similarity index 99%
rename from docs/source/en/model_doc/t5.mdx
rename to docs/source/en/model_doc/t5.md
index 58074f1403..b5fa747a81 100644
--- a/docs/source/en/model_doc/t5.mdx
+++ b/docs/source/en/model_doc/t5.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # T5
diff --git a/docs/source/en/model_doc/t5v1.1.mdx b/docs/source/en/model_doc/t5v1.1.md
similarity index 94%
rename from docs/source/en/model_doc/t5v1.1.mdx
rename to docs/source/en/model_doc/t5v1.1.md
index a5b64f77dc..900e26f521 100644
--- a/docs/source/en/model_doc/t5v1.1.mdx
+++ b/docs/source/en/model_doc/t5v1.1.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # T5v1.1
diff --git a/docs/source/en/model_doc/table-transformer.mdx b/docs/source/en/model_doc/table-transformer.md
similarity index 96%
rename from docs/source/en/model_doc/table-transformer.mdx
rename to docs/source/en/model_doc/table-transformer.md
index 07197f233d..7ea7ae8cd3 100644
--- a/docs/source/en/model_doc/table-transformer.mdx
+++ b/docs/source/en/model_doc/table-transformer.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # Table Transformer
diff --git a/docs/source/en/model_doc/tapas.mdx b/docs/source/en/model_doc/tapas.md
similarity index 99%
rename from docs/source/en/model_doc/tapas.mdx
rename to docs/source/en/model_doc/tapas.md
index fadda58957..1c76015f28 100644
--- a/docs/source/en/model_doc/tapas.mdx
+++ b/docs/source/en/model_doc/tapas.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # TAPAS
diff --git a/docs/source/en/model_doc/tapex.mdx b/docs/source/en/model_doc/tapex.md
similarity index 97%
rename from docs/source/en/model_doc/tapex.mdx
rename to docs/source/en/model_doc/tapex.md
index f6e65764e5..8cebceeb73 100644
--- a/docs/source/en/model_doc/tapex.mdx
+++ b/docs/source/en/model_doc/tapex.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # TAPEX
diff --git a/docs/source/en/model_doc/time_series_transformer.mdx b/docs/source/en/model_doc/time_series_transformer.md
similarity index 96%
rename from docs/source/en/model_doc/time_series_transformer.mdx
rename to docs/source/en/model_doc/time_series_transformer.md
index 23be651426..f20387fb3a 100644
--- a/docs/source/en/model_doc/time_series_transformer.mdx
+++ b/docs/source/en/model_doc/time_series_transformer.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # Time Series Transformer
diff --git a/docs/source/en/model_doc/timesformer.mdx b/docs/source/en/model_doc/timesformer.md
similarity index 94%
rename from docs/source/en/model_doc/timesformer.mdx
rename to docs/source/en/model_doc/timesformer.md
index 157f806e42..d87fde4fb2 100644
--- a/docs/source/en/model_doc/timesformer.mdx
+++ b/docs/source/en/model_doc/timesformer.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # TimeSformer
diff --git a/docs/source/en/model_doc/trajectory_transformer.mdx b/docs/source/en/model_doc/trajectory_transformer.md
similarity index 94%
rename from docs/source/en/model_doc/trajectory_transformer.mdx
rename to docs/source/en/model_doc/trajectory_transformer.md
index da7a55a50e..25b24e3db6 100644
--- a/docs/source/en/model_doc/trajectory_transformer.mdx
+++ b/docs/source/en/model_doc/trajectory_transformer.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # Trajectory Transformer
diff --git a/docs/source/en/model_doc/transfo-xl.mdx b/docs/source/en/model_doc/transfo-xl.md
similarity index 97%
rename from docs/source/en/model_doc/transfo-xl.mdx
rename to docs/source/en/model_doc/transfo-xl.md
index 83ce8bc76f..beb5ba2fea 100644
--- a/docs/source/en/model_doc/transfo-xl.mdx
+++ b/docs/source/en/model_doc/transfo-xl.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # Transformer XL
diff --git a/docs/source/en/model_doc/trocr.mdx b/docs/source/en/model_doc/trocr.md
similarity index 97%
rename from docs/source/en/model_doc/trocr.mdx
rename to docs/source/en/model_doc/trocr.md
index 8ad6566862..bfab93ad66 100644
--- a/docs/source/en/model_doc/trocr.mdx
+++ b/docs/source/en/model_doc/trocr.md
@@ -7,6 +7,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an
 "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 specific language governing permissions and limitations under the License. -->
 
 # TrOCR
diff --git a/docs/source/en/model_doc/tvlt.mdx b/docs/source/en/model_doc/tvlt.md
similarity index 96%
rename from docs/source/en/model_doc/tvlt.mdx
rename to docs/source/en/model_doc/tvlt.md
index 56bc37d024..5ddb6badb7 100644
--- a/docs/source/en/model_doc/tvlt.mdx
+++ b/docs/source/en/model_doc/tvlt.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # TVLT
diff --git a/docs/source/en/model_doc/ul2.mdx b/docs/source/en/model_doc/ul2.md
similarity index 94%
rename from docs/source/en/model_doc/ul2.mdx
rename to docs/source/en/model_doc/ul2.md
index 2481285747..3863f23a7d 100644
--- a/docs/source/en/model_doc/ul2.mdx
+++ b/docs/source/en/model_doc/ul2.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # UL2
diff --git a/docs/source/en/model_doc/unispeech-sat.mdx b/docs/source/en/model_doc/unispeech-sat.md
similarity index 95%
rename from docs/source/en/model_doc/unispeech-sat.mdx
rename to docs/source/en/model_doc/unispeech-sat.md
index d045bcbe69..25489d9eef 100644
--- a/docs/source/en/model_doc/unispeech-sat.mdx
+++ b/docs/source/en/model_doc/unispeech-sat.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # UniSpeech-SAT
diff --git a/docs/source/en/model_doc/unispeech.mdx b/docs/source/en/model_doc/unispeech.md
similarity index 94%
rename from docs/source/en/model_doc/unispeech.mdx
rename to docs/source/en/model_doc/unispeech.md
index 3d170b63ce..8338aa1bda 100644
--- a/docs/source/en/model_doc/unispeech.mdx
+++ b/docs/source/en/model_doc/unispeech.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # UniSpeech
diff --git a/docs/source/en/model_doc/upernet.mdx b/docs/source/en/model_doc/upernet.md
similarity index 96%
rename from docs/source/en/model_doc/upernet.mdx
rename to docs/source/en/model_doc/upernet.md
index e839165e74..db651acaa4 100644
--- a/docs/source/en/model_doc/upernet.mdx
+++ b/docs/source/en/model_doc/upernet.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # UPerNet
diff --git a/docs/source/en/model_doc/van.mdx b/docs/source/en/model_doc/van.md
similarity index 95%
rename from docs/source/en/model_doc/van.mdx
rename to docs/source/en/model_doc/van.md
index e59af72758..c6d7653363 100644
--- a/docs/source/en/model_doc/van.mdx
+++ b/docs/source/en/model_doc/van.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # VAN
diff --git a/docs/source/en/model_doc/videomae.mdx b/docs/source/en/model_doc/videomae.md
similarity index 96%
rename from docs/source/en/model_doc/videomae.mdx
rename to docs/source/en/model_doc/videomae.md
index 00237055ac..7dbff1b069 100644
--- a/docs/source/en/model_doc/videomae.mdx
+++ b/docs/source/en/model_doc/videomae.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # VideoMAE
diff --git a/docs/source/en/model_doc/vilt.mdx b/docs/source/en/model_doc/vilt.md
similarity index 96%
rename from docs/source/en/model_doc/vilt.mdx
rename to docs/source/en/model_doc/vilt.md
index 7c8653e1a3..4170e374d8 100644
--- a/docs/source/en/model_doc/vilt.mdx
+++ b/docs/source/en/model_doc/vilt.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # ViLT
diff --git a/docs/source/en/model_doc/vision-encoder-decoder.mdx b/docs/source/en/model_doc/vision-encoder-decoder.md
similarity index 98%
rename from docs/source/en/model_doc/vision-encoder-decoder.mdx
rename to docs/source/en/model_doc/vision-encoder-decoder.md
index 0241224c06..0beeaeae10 100644
--- a/docs/source/en/model_doc/vision-encoder-decoder.mdx
+++ b/docs/source/en/model_doc/vision-encoder-decoder.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # Vision Encoder Decoder Models
diff --git a/docs/source/en/model_doc/vision-text-dual-encoder.mdx b/docs/source/en/model_doc/vision-text-dual-encoder.md
similarity index 92%
rename from docs/source/en/model_doc/vision-text-dual-encoder.mdx
rename to docs/source/en/model_doc/vision-text-dual-encoder.md
index 8088efaa8c..6fa9728cac 100644
--- a/docs/source/en/model_doc/vision-text-dual-encoder.mdx
+++ b/docs/source/en/model_doc/vision-text-dual-encoder.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # VisionTextDualEncoder
diff --git a/docs/source/en/model_doc/visual_bert.mdx b/docs/source/en/model_doc/visual_bert.md
similarity index 97%
rename from docs/source/en/model_doc/visual_bert.mdx
rename to docs/source/en/model_doc/visual_bert.md
index df8858b1fa..7d84c0d9fa 100644
--- a/docs/source/en/model_doc/visual_bert.mdx
+++ b/docs/source/en/model_doc/visual_bert.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # VisualBERT
diff --git a/docs/source/en/model_doc/vit.mdx b/docs/source/en/model_doc/vit.md
similarity index 98%
rename from docs/source/en/model_doc/vit.mdx
rename to docs/source/en/model_doc/vit.md
index 31977a45ca..409580d094 100644
--- a/docs/source/en/model_doc/vit.mdx
+++ b/docs/source/en/model_doc/vit.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # Vision Transformer (ViT)
diff --git a/docs/source/en/model_doc/vit_hybrid.mdx b/docs/source/en/model_doc/vit_hybrid.md
similarity index 95%
rename from docs/source/en/model_doc/vit_hybrid.mdx
rename to docs/source/en/model_doc/vit_hybrid.md
index f53b3ff10d..84969cd0f6 100644
--- a/docs/source/en/model_doc/vit_hybrid.mdx
+++ b/docs/source/en/model_doc/vit_hybrid.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # Hybrid Vision Transformer (ViT Hybrid)
diff --git a/docs/source/en/model_doc/vit_mae.mdx b/docs/source/en/model_doc/vit_mae.md
similarity index 96%
rename from docs/source/en/model_doc/vit_mae.mdx
rename to docs/source/en/model_doc/vit_mae.md
index 714a68e152..c14cc7e57c 100644
--- a/docs/source/en/model_doc/vit_mae.mdx
+++ b/docs/source/en/model_doc/vit_mae.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # ViTMAE
diff --git a/docs/source/en/model_doc/vit_msn.mdx b/docs/source/en/model_doc/vit_msn.md
similarity index 96%
rename from docs/source/en/model_doc/vit_msn.mdx
rename to docs/source/en/model_doc/vit_msn.md
index f4e4afcac3..ded0245194 100644
--- a/docs/source/en/model_doc/vit_msn.mdx
+++ b/docs/source/en/model_doc/vit_msn.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # ViTMSN
diff --git a/docs/source/en/model_doc/wav2vec2-conformer.mdx b/docs/source/en/model_doc/wav2vec2-conformer.md
similarity index 94%
rename from docs/source/en/model_doc/wav2vec2-conformer.mdx
rename to docs/source/en/model_doc/wav2vec2-conformer.md
index cf18534619..87e255cd0c 100644
--- a/docs/source/en/model_doc/wav2vec2-conformer.mdx
+++ b/docs/source/en/model_doc/wav2vec2-conformer.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # Wav2Vec2-Conformer
diff --git a/docs/source/en/model_doc/wav2vec2.mdx b/docs/source/en/model_doc/wav2vec2.md
similarity index 98%
rename from docs/source/en/model_doc/wav2vec2.mdx
rename to docs/source/en/model_doc/wav2vec2.md
index 9b084de8e9..3a67f66d9d 100644
--- a/docs/source/en/model_doc/wav2vec2.mdx
+++ b/docs/source/en/model_doc/wav2vec2.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # Wav2Vec2
diff --git a/docs/source/en/model_doc/wav2vec2_phoneme.mdx b/docs/source/en/model_doc/wav2vec2_phoneme.md
similarity index 94%
rename from docs/source/en/model_doc/wav2vec2_phoneme.mdx
rename to docs/source/en/model_doc/wav2vec2_phoneme.md
index b39cf66ce1..a852bef637 100644
--- a/docs/source/en/model_doc/wav2vec2_phoneme.mdx
+++ b/docs/source/en/model_doc/wav2vec2_phoneme.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # Wav2Vec2Phoneme
diff --git a/docs/source/en/model_doc/wavlm.mdx b/docs/source/en/model_doc/wavlm.md
similarity index 95%
rename from docs/source/en/model_doc/wavlm.mdx
rename to docs/source/en/model_doc/wavlm.md
index ce58b1c965..2754304d82 100644
--- a/docs/source/en/model_doc/wavlm.mdx
+++ b/docs/source/en/model_doc/wavlm.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # WavLM
diff --git a/docs/source/en/model_doc/whisper.mdx b/docs/source/en/model_doc/whisper.md
similarity index 95%
rename from docs/source/en/model_doc/whisper.mdx
rename to docs/source/en/model_doc/whisper.md
index 52a8b5953c..fbf806cd41 100644
--- a/docs/source/en/model_doc/whisper.mdx
+++ b/docs/source/en/model_doc/whisper.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # Whisper
diff --git a/docs/source/en/model_doc/xclip.mdx b/docs/source/en/model_doc/xclip.md
similarity index 96%
rename from docs/source/en/model_doc/xclip.mdx
rename to docs/source/en/model_doc/xclip.md
index a49ed8b913..45c4c3db74 100644
--- a/docs/source/en/model_doc/xclip.mdx
+++ b/docs/source/en/model_doc/xclip.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # X-CLIP
diff --git a/docs/source/en/model_doc/xglm.mdx b/docs/source/en/model_doc/xglm.md
similarity index 95%
rename from docs/source/en/model_doc/xglm.mdx
rename to docs/source/en/model_doc/xglm.md
index fb4c7a1428..1b184c17e8 100644
--- a/docs/source/en/model_doc/xglm.mdx
+++ b/docs/source/en/model_doc/xglm.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # XGLM
diff --git a/docs/source/en/model_doc/xlm-prophetnet.mdx b/docs/source/en/model_doc/xlm-prophetnet.md
similarity index 95%
rename from docs/source/en/model_doc/xlm-prophetnet.mdx
rename to docs/source/en/model_doc/xlm-prophetnet.md
index ba6b91da6c..5e7ba5b7e3 100644
--- a/docs/source/en/model_doc/xlm-prophetnet.mdx
+++ b/docs/source/en/model_doc/xlm-prophetnet.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # XLM-ProphetNet
diff --git a/docs/source/en/model_doc/xlm-roberta-xl.mdx b/docs/source/en/model_doc/xlm-roberta-xl.md
similarity index 95%
rename from docs/source/en/model_doc/xlm-roberta-xl.mdx
rename to docs/source/en/model_doc/xlm-roberta-xl.md
index 7c9efa593d..b659294607 100644
--- a/docs/source/en/model_doc/xlm-roberta-xl.mdx
+++ b/docs/source/en/model_doc/xlm-roberta-xl.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # XLM-RoBERTa-XL
diff --git a/docs/source/en/model_doc/xlm-roberta.mdx b/docs/source/en/model_doc/xlm-roberta.md
similarity index 98%
rename from docs/source/en/model_doc/xlm-roberta.mdx
rename to docs/source/en/model_doc/xlm-roberta.md
index f7fe74edeb..935003156f 100644
--- a/docs/source/en/model_doc/xlm-roberta.mdx
+++ b/docs/source/en/model_doc/xlm-roberta.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # XLM-RoBERTa
diff --git a/docs/source/en/model_doc/xlm-v.mdx b/docs/source/en/model_doc/xlm-v.md
similarity index 94%
rename from docs/source/en/model_doc/xlm-v.mdx
rename to docs/source/en/model_doc/xlm-v.md
index 4ad07edecb..38bed0dc46 100644
--- a/docs/source/en/model_doc/xlm-v.mdx
+++ b/docs/source/en/model_doc/xlm-v.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # XLM-V
diff --git a/docs/source/en/model_doc/xlm.mdx b/docs/source/en/model_doc/xlm.md
similarity index 97%
rename from docs/source/en/model_doc/xlm.mdx
rename to docs/source/en/model_doc/xlm.md
index 846ca73b6b..8b5b31a2db 100644
--- a/docs/source/en/model_doc/xlm.mdx
+++ b/docs/source/en/model_doc/xlm.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # XLM
diff --git a/docs/source/en/model_doc/xlnet.mdx b/docs/source/en/model_doc/xlnet.md
similarity index 97%
rename from docs/source/en/model_doc/xlnet.mdx
rename to docs/source/en/model_doc/xlnet.md
index 599c865c71..3685728cd7 100644
--- a/docs/source/en/model_doc/xlnet.mdx
+++ b/docs/source/en/model_doc/xlnet.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # XLNet
diff --git a/docs/source/en/model_doc/xls_r.mdx b/docs/source/en/model_doc/xls_r.md
similarity index 94%
rename from docs/source/en/model_doc/xls_r.mdx
rename to docs/source/en/model_doc/xls_r.md
index 82a7e3b8af..8e22004244 100644
--- a/docs/source/en/model_doc/xls_r.mdx
+++ b/docs/source/en/model_doc/xls_r.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # XLS-R
diff --git a/docs/source/en/model_doc/xlsr_wav2vec2.mdx b/docs/source/en/model_doc/xlsr_wav2vec2.md
similarity index 93%
rename from docs/source/en/model_doc/xlsr_wav2vec2.mdx
rename to docs/source/en/model_doc/xlsr_wav2vec2.md
index 32229f28b1..643d37416d 100644
--- a/docs/source/en/model_doc/xlsr_wav2vec2.mdx
+++ b/docs/source/en/model_doc/xlsr_wav2vec2.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # XLSR-Wav2Vec2
diff --git a/docs/source/en/model_doc/xmod.mdx b/docs/source/en/model_doc/xmod.md
similarity index 96%
rename from docs/source/en/model_doc/xmod.mdx
rename to docs/source/en/model_doc/xmod.md
index c240889b02..5a3409bbc4 100644
--- a/docs/source/en/model_doc/xmod.mdx
+++ b/docs/source/en/model_doc/xmod.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # X-MOD
diff --git a/docs/source/en/model_doc/yolos.mdx b/docs/source/en/model_doc/yolos.md
similarity index 95%
rename from docs/source/en/model_doc/yolos.mdx
rename to docs/source/en/model_doc/yolos.md
index ec5cf6cbb4..6185c3a067 100644
--- a/docs/source/en/model_doc/yolos.mdx
+++ b/docs/source/en/model_doc/yolos.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # YOLOS
diff --git a/docs/source/en/model_doc/yoso.mdx b/docs/source/en/model_doc/yoso.md
similarity index 96%
rename from docs/source/en/model_doc/yoso.mdx
rename to docs/source/en/model_doc/yoso.md
index 66b05b33cb..4b98cd348c 100644
--- a/docs/source/en/model_doc/yoso.mdx
+++ b/docs/source/en/model_doc/yoso.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # YOSO
diff --git a/docs/source/en/model_sharing.mdx b/docs/source/en/model_sharing.md
similarity index 98%
rename from docs/source/en/model_sharing.mdx
rename to docs/source/en/model_sharing.md
index bae458be79..078bc29fe2 100644
--- a/docs/source/en/model_sharing.mdx
+++ b/docs/source/en/model_sharing.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # Share a model
diff --git a/docs/source/en/model_summary.mdx b/docs/source/en/model_summary.md
similarity index 99%
rename from docs/source/en/model_summary.mdx
rename to docs/source/en/model_summary.md
index bc93c3d603..10acb4c502 100644
--- a/docs/source/en/model_summary.mdx
+++ b/docs/source/en/model_summary.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # The Transformer model family
diff --git a/docs/source/en/multilingual.mdx b/docs/source/en/multilingual.md
similarity index 97%
rename from docs/source/en/multilingual.mdx
rename to docs/source/en/multilingual.md
index 7c95de6ffc..72192487f1 100644
--- a/docs/source/en/multilingual.mdx
+++ b/docs/source/en/multilingual.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # Multilingual models for inference
diff --git a/docs/source/en/pad_truncation.mdx b/docs/source/en/pad_truncation.md
similarity index 97%
rename from docs/source/en/pad_truncation.mdx
rename to docs/source/en/pad_truncation.md
index 8862e0be00..8094dc1bc2 100644
--- a/docs/source/en/pad_truncation.mdx
+++ b/docs/source/en/pad_truncation.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # Padding and truncation
diff --git a/docs/source/en/perf_hardware.mdx b/docs/source/en/perf_hardware.md
similarity index 97%
rename from docs/source/en/perf_hardware.mdx
rename to docs/source/en/perf_hardware.md
index b28df49892..98579bbf87 100644
--- a/docs/source/en/perf_hardware.mdx
+++ b/docs/source/en/perf_hardware.md
@@ -12,6 +12,10 @@ distributed under the License is distributed on an "AS IS" BASIS,
 WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 See the License for the specific language governing permissions and
 limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 
diff --git a/docs/source/en/perf_infer_cpu.mdx b/docs/source/en/perf_infer_cpu.md
similarity index 96%
rename from docs/source/en/perf_infer_cpu.mdx
rename to docs/source/en/perf_infer_cpu.md
index a3df21e93a..a7a524ae1e 100644
--- a/docs/source/en/perf_infer_cpu.mdx
+++ b/docs/source/en/perf_infer_cpu.md
@@ -7,6 +7,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # Efficient Inference on CPU
diff --git a/docs/source/en/perf_infer_gpu_many.mdx b/docs/source/en/perf_infer_gpu_many.md
similarity index 87%
rename from docs/source/en/perf_infer_gpu_many.mdx
rename to docs/source/en/perf_infer_gpu_many.md
index d8a24d6ab8..f46ad59c46 100644
--- a/docs/source/en/perf_infer_gpu_many.mdx
+++ b/docs/source/en/perf_infer_gpu_many.md
@@ -7,6 +7,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # Efficient Inference on a Multiple GPUs
diff --git a/docs/source/en/perf_infer_gpu_one.mdx b/docs/source/en/perf_infer_gpu_one.md
similarity index 98%
rename from docs/source/en/perf_infer_gpu_one.mdx
rename to docs/source/en/perf_infer_gpu_one.md
index 5c8f874c37..080d0709cd 100644
--- a/docs/source/en/perf_infer_gpu_one.mdx
+++ b/docs/source/en/perf_infer_gpu_one.md
@@ -7,6 +7,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # Efficient Inference on a Single GPU
diff --git a/docs/source/en/perf_infer_special.mdx b/docs/source/en/perf_infer_special.md
similarity index 81%
rename from docs/source/en/perf_infer_special.mdx
rename to docs/source/en/perf_infer_special.md
index e18a9a1048..e5744754b8 100644
--- a/docs/source/en/perf_infer_special.mdx
+++ b/docs/source/en/perf_infer_special.md
@@ -7,6 +7,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # Inference on Specialized Hardware
diff --git a/docs/source/en/perf_train_cpu.mdx b/docs/source/en/perf_train_cpu.md
similarity index 95%
rename from docs/source/en/perf_train_cpu.mdx
rename to docs/source/en/perf_train_cpu.md
index aa7a9ec2bf..9c81820ce7 100644
--- a/docs/source/en/perf_train_cpu.mdx
+++ b/docs/source/en/perf_train_cpu.md
@@ -7,6 +7,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # Efficient Training on CPU
diff --git a/docs/source/en/perf_train_cpu_many.mdx b/docs/source/en/perf_train_cpu_many.md
similarity index 97%
rename from docs/source/en/perf_train_cpu_many.mdx
rename to docs/source/en/perf_train_cpu_many.md
index 6c5e0b77a4..4c131430ba 100644
--- a/docs/source/en/perf_train_cpu_many.mdx
+++ b/docs/source/en/perf_train_cpu_many.md
@@ -7,6 +7,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # Efficient Training on Multiple CPUs
diff --git a/docs/source/en/perf_train_gpu_many.mdx b/docs/source/en/perf_train_gpu_many.md
similarity index 99%
rename from docs/source/en/perf_train_gpu_many.mdx
rename to docs/source/en/perf_train_gpu_many.md
index e756732daf..d8d6c9f09d 100644
--- a/docs/source/en/perf_train_gpu_many.mdx
+++ b/docs/source/en/perf_train_gpu_many.md
@@ -7,6 +7,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # Efficient Training on Multiple GPUs
diff --git a/docs/source/en/perf_train_gpu_one.mdx b/docs/source/en/perf_train_gpu_one.md
similarity index 99%
rename from docs/source/en/perf_train_gpu_one.mdx
rename to docs/source/en/perf_train_gpu_one.md
index 5128486d6d..70f24fb1bc 100644
--- a/docs/source/en/perf_train_gpu_one.mdx
+++ b/docs/source/en/perf_train_gpu_one.md
@@ -7,6 +7,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # Efficient Training on a Single GPU
diff --git a/docs/source/en/perf_train_special.mdx b/docs/source/en/perf_train_special.md
similarity index 85%
rename from docs/source/en/perf_train_special.mdx
rename to docs/source/en/perf_train_special.md
index cb6b8d4090..48727b24fe 100644
--- a/docs/source/en/perf_train_special.mdx
+++ b/docs/source/en/perf_train_special.md
@@ -7,6 +7,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # Training on Specialized Hardware
diff --git a/docs/source/en/perf_train_tpu.mdx b/docs/source/en/perf_train_tpu.md
similarity index 84%
rename from docs/source/en/perf_train_tpu.mdx
rename to docs/source/en/perf_train_tpu.md
index bc37e00877..c7b344ad81 100644
--- a/docs/source/en/perf_train_tpu.mdx
+++ b/docs/source/en/perf_train_tpu.md
@@ -7,6 +7,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # Training on TPUs
diff --git a/docs/source/en/perf_train_tpu_tf.mdx b/docs/source/en/perf_train_tpu_tf.md
similarity index 98%
rename from docs/source/en/perf_train_tpu_tf.mdx
rename to docs/source/en/perf_train_tpu_tf.md
index 344031f647..011421b629 100644
--- a/docs/source/en/perf_train_tpu_tf.mdx
+++ b/docs/source/en/perf_train_tpu_tf.md
@@ -7,6 +7,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # Training on TPU with TensorFlow
diff --git a/docs/source/en/performance.mdx b/docs/source/en/performance.md
similarity index 96%
rename from docs/source/en/performance.mdx
rename to docs/source/en/performance.md
index 6c68e9b2ac..1b88307b70 100644
--- a/docs/source/en/performance.mdx
+++ b/docs/source/en/performance.md
@@ -12,6 +12,10 @@ distributed under the License is distributed on an "AS IS" BASIS,
 WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 See the License for the specific language governing permissions and
 limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # Performance and Scalability
diff --git a/docs/source/en/perplexity.mdx b/docs/source/en/perplexity.md
similarity index 97%
rename from docs/source/en/perplexity.mdx
rename to docs/source/en/perplexity.md
index 76ffd33856..18abc0305b 100644
--- a/docs/source/en/perplexity.mdx
+++ b/docs/source/en/perplexity.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # Perplexity of fixed-length models
diff --git a/docs/source/en/philosophy.mdx b/docs/source/en/philosophy.md
similarity index 97%
rename from docs/source/en/philosophy.mdx
rename to docs/source/en/philosophy.md
index 7788d78362..cad1e2ccdc 100644
--- a/docs/source/en/philosophy.mdx
+++ b/docs/source/en/philosophy.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # Philosophy
diff --git a/docs/source/en/pipeline_tutorial.mdx b/docs/source/en/pipeline_tutorial.md
similarity index 98%
rename from docs/source/en/pipeline_tutorial.mdx
rename to docs/source/en/pipeline_tutorial.md
index ee85d52251..1b13c401b9 100644
--- a/docs/source/en/pipeline_tutorial.mdx
+++ b/docs/source/en/pipeline_tutorial.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # Pipelines for inference
diff --git a/docs/source/en/pipeline_webserver.mdx b/docs/source/en/pipeline_webserver.md
similarity index 97%
rename from docs/source/en/pipeline_webserver.mdx
rename to docs/source/en/pipeline_webserver.md
index f62985ec26..1421dc61f7 100644
--- a/docs/source/en/pipeline_webserver.mdx
+++ b/docs/source/en/pipeline_webserver.md
@@ -1,3 +1,7 @@
+<!--⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+-->
+
 # Using pipelines for a webserver
 
 <Tip>
diff --git a/docs/source/en/pr_checks.mdx b/docs/source/en/pr_checks.md
similarity index 97%
rename from docs/source/en/pr_checks.mdx
rename to docs/source/en/pr_checks.md
index 1e3f62b22a..6aeee89d75 100644
--- a/docs/source/en/pr_checks.mdx
+++ b/docs/source/en/pr_checks.md
@@ -12,6 +12,10 @@ distributed under the License is distributed on an "AS IS" BASIS,
 WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 See the License for the specific language governing permissions and
 limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # Checks on a Pull Request
diff --git a/docs/source/en/preprocessing.mdx b/docs/source/en/preprocessing.md
similarity index 99%
rename from docs/source/en/preprocessing.mdx
rename to docs/source/en/preprocessing.md
index c2933099b0..1f8eb4b154 100644
--- a/docs/source/en/preprocessing.mdx
+++ b/docs/source/en/preprocessing.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # Preprocess
diff --git a/docs/source/en/quicktour.mdx b/docs/source/en/quicktour.md
similarity index 99%
rename from docs/source/en/quicktour.mdx
rename to docs/source/en/quicktour.md
index 221cf91ff8..442542234f 100644
--- a/docs/source/en/quicktour.mdx
+++ b/docs/source/en/quicktour.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # Quick tour
diff --git a/docs/source/en/run_scripts.mdx b/docs/source/en/run_scripts.md
similarity index 98%
rename from docs/source/en/run_scripts.mdx
rename to docs/source/en/run_scripts.md
index 58d6b8dd3e..3b40b6ea06 100644
--- a/docs/source/en/run_scripts.mdx
+++ b/docs/source/en/run_scripts.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # Train with a script
diff --git a/docs/source/en/sagemaker.mdx b/docs/source/en/sagemaker.md
similarity index 87%
rename from docs/source/en/sagemaker.mdx
rename to docs/source/en/sagemaker.md
index 1ffdd4326e..f0a5a5f9c1 100644
--- a/docs/source/en/sagemaker.mdx
+++ b/docs/source/en/sagemaker.md
@@ -12,6 +12,10 @@ distributed under the License is distributed on an "AS IS" BASIS,
 WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 See the License for the specific language governing permissions and
 limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # Run training on Amazon SageMaker
diff --git a/docs/source/en/serialization.mdx b/docs/source/en/serialization.md
similarity index 98%
rename from docs/source/en/serialization.mdx
rename to docs/source/en/serialization.md
index 022cf460f8..9fec884a8b 100644
--- a/docs/source/en/serialization.mdx
+++ b/docs/source/en/serialization.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # Export to ONNX
diff --git a/docs/source/en/task_summary.mdx b/docs/source/en/task_summary.md
similarity index 99%
rename from docs/source/en/task_summary.mdx
rename to docs/source/en/task_summary.md
index 67181d2d0c..c1e2c9a0ba 100644
--- a/docs/source/en/task_summary.mdx
+++ b/docs/source/en/task_summary.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # What 🤗 Transformers can do
diff --git a/docs/source/en/tasks/asr.mdx b/docs/source/en/tasks/asr.md
similarity index 98%
rename from docs/source/en/tasks/asr.mdx
rename to docs/source/en/tasks/asr.md
index 06737f8c8c..d01269ba60 100644
--- a/docs/source/en/tasks/asr.mdx
+++ b/docs/source/en/tasks/asr.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # Automatic speech recognition
diff --git a/docs/source/en/tasks/audio_classification.mdx b/docs/source/en/tasks/audio_classification.md
similarity index 98%
rename from docs/source/en/tasks/audio_classification.mdx
rename to docs/source/en/tasks/audio_classification.md
index d79bd9033e..743a797fc5 100644
--- a/docs/source/en/tasks/audio_classification.mdx
+++ b/docs/source/en/tasks/audio_classification.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # Audio classification
diff --git a/docs/source/en/tasks/document_question_answering.mdx b/docs/source/en/tasks/document_question_answering.md
similarity index 99%
rename from docs/source/en/tasks/document_question_answering.mdx
rename to docs/source/en/tasks/document_question_answering.md
index 7294e9f8fd..24bf3a069a 100644
--- a/docs/source/en/tasks/document_question_answering.mdx
+++ b/docs/source/en/tasks/document_question_answering.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # Document Question Answering
diff --git a/docs/source/en/tasks/image_captioning.mdx b/docs/source/en/tasks/image_captioning.md
similarity index 97%
rename from docs/source/en/tasks/image_captioning.mdx
rename to docs/source/en/tasks/image_captioning.md
index 2922de0549..71e81b4651 100644
--- a/docs/source/en/tasks/image_captioning.mdx
+++ b/docs/source/en/tasks/image_captioning.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 
diff --git a/docs/source/en/tasks/image_classification.mdx b/docs/source/en/tasks/image_classification.md
similarity index 99%
rename from docs/source/en/tasks/image_classification.mdx
rename to docs/source/en/tasks/image_classification.md
index c1a2c94eb5..67c3d0d7f0 100644
--- a/docs/source/en/tasks/image_classification.mdx
+++ b/docs/source/en/tasks/image_classification.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # Image classification
diff --git a/docs/source/en/tasks/language_modeling.mdx b/docs/source/en/tasks/language_modeling.md
similarity index 99%
rename from docs/source/en/tasks/language_modeling.mdx
rename to docs/source/en/tasks/language_modeling.md
index 676156ede8..f6f9b37afe 100644
--- a/docs/source/en/tasks/language_modeling.mdx
+++ b/docs/source/en/tasks/language_modeling.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # Causal language modeling
diff --git a/docs/source/en/tasks/masked_language_modeling.mdx b/docs/source/en/tasks/masked_language_modeling.md
similarity index 99%
rename from docs/source/en/tasks/masked_language_modeling.mdx
rename to docs/source/en/tasks/masked_language_modeling.md
index 1452f161b1..5920bfcaf8 100644
--- a/docs/source/en/tasks/masked_language_modeling.mdx
+++ b/docs/source/en/tasks/masked_language_modeling.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # Masked language modeling
diff --git a/docs/source/en/tasks/monocular_depth_estimation.mdx b/docs/source/en/tasks/monocular_depth_estimation.md
similarity index 96%
rename from docs/source/en/tasks/monocular_depth_estimation.mdx
rename to docs/source/en/tasks/monocular_depth_estimation.md
index a2721d659e..fa59771cbb 100644
--- a/docs/source/en/tasks/monocular_depth_estimation.mdx
+++ b/docs/source/en/tasks/monocular_depth_estimation.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # Monocular depth estimation
diff --git a/docs/source/en/tasks/multiple_choice.mdx b/docs/source/en/tasks/multiple_choice.md
similarity index 99%
rename from docs/source/en/tasks/multiple_choice.mdx
rename to docs/source/en/tasks/multiple_choice.md
index 5a06c24d11..7b7d6bfa69 100644
--- a/docs/source/en/tasks/multiple_choice.mdx
+++ b/docs/source/en/tasks/multiple_choice.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # Multiple choice
diff --git a/docs/source/en/tasks/object_detection.mdx b/docs/source/en/tasks/object_detection.md
similarity index 99%
rename from docs/source/en/tasks/object_detection.mdx
rename to docs/source/en/tasks/object_detection.md
index 411ed7d2e7..a38c33c927 100644
--- a/docs/source/en/tasks/object_detection.mdx
+++ b/docs/source/en/tasks/object_detection.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # Object detection
diff --git a/docs/source/en/tasks/question_answering.mdx b/docs/source/en/tasks/question_answering.md
similarity index 99%
rename from docs/source/en/tasks/question_answering.mdx
rename to docs/source/en/tasks/question_answering.md
index ae31a070fc..cb268e520e 100644
--- a/docs/source/en/tasks/question_answering.mdx
+++ b/docs/source/en/tasks/question_answering.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # Question answering
diff --git a/docs/source/en/tasks/semantic_segmentation.mdx b/docs/source/en/tasks/semantic_segmentation.md
similarity index 99%
rename from docs/source/en/tasks/semantic_segmentation.mdx
rename to docs/source/en/tasks/semantic_segmentation.md
index 89abe14c75..267d0083b9 100644
--- a/docs/source/en/tasks/semantic_segmentation.mdx
+++ b/docs/source/en/tasks/semantic_segmentation.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # Semantic segmentation
diff --git a/docs/source/en/tasks/sequence_classification.mdx b/docs/source/en/tasks/sequence_classification.md
similarity index 99%
rename from docs/source/en/tasks/sequence_classification.mdx
rename to docs/source/en/tasks/sequence_classification.md
index db7bdc15b3..dd1ad03277 100644
--- a/docs/source/en/tasks/sequence_classification.mdx
+++ b/docs/source/en/tasks/sequence_classification.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # Text classification
diff --git a/docs/source/en/tasks/summarization.mdx b/docs/source/en/tasks/summarization.md
similarity index 99%
rename from docs/source/en/tasks/summarization.mdx
rename to docs/source/en/tasks/summarization.md
index ce480bccb7..cd0db0ca75 100644
--- a/docs/source/en/tasks/summarization.mdx
+++ b/docs/source/en/tasks/summarization.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # Summarization
diff --git a/docs/source/en/tasks/text-to-speech.mdx b/docs/source/en/tasks/text-to-speech.md
similarity index 99%
rename from docs/source/en/tasks/text-to-speech.mdx
rename to docs/source/en/tasks/text-to-speech.md
index 21c76841e3..6a14972e7c 100644
--- a/docs/source/en/tasks/text-to-speech.mdx
+++ b/docs/source/en/tasks/text-to-speech.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # Text to speech
diff --git a/docs/source/en/tasks/token_classification.mdx b/docs/source/en/tasks/token_classification.md
similarity index 99%
rename from docs/source/en/tasks/token_classification.mdx
rename to docs/source/en/tasks/token_classification.md
index 90af3a21bb..f9a84853b3 100644
--- a/docs/source/en/tasks/token_classification.mdx
+++ b/docs/source/en/tasks/token_classification.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # Token classification
diff --git a/docs/source/en/tasks/translation.mdx b/docs/source/en/tasks/translation.md
similarity index 98%
rename from docs/source/en/tasks/translation.mdx
rename to docs/source/en/tasks/translation.md
index 530390f1c3..760b02ee39 100644
--- a/docs/source/en/tasks/translation.mdx
+++ b/docs/source/en/tasks/translation.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # Translation
diff --git a/docs/source/en/tasks/video_classification.mdx b/docs/source/en/tasks/video_classification.md
similarity index 99%
rename from docs/source/en/tasks/video_classification.mdx
rename to docs/source/en/tasks/video_classification.md
index 57dc00c1bf..c28f1c4019 100644
--- a/docs/source/en/tasks/video_classification.mdx
+++ b/docs/source/en/tasks/video_classification.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # Video classification
diff --git a/docs/source/en/tasks/zero_shot_image_classification.mdx b/docs/source/en/tasks/zero_shot_image_classification.md
similarity index 97%
rename from docs/source/en/tasks/zero_shot_image_classification.mdx
rename to docs/source/en/tasks/zero_shot_image_classification.md
index 2784d36508..3177255b1c 100644
--- a/docs/source/en/tasks/zero_shot_image_classification.mdx
+++ b/docs/source/en/tasks/zero_shot_image_classification.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # Zero-shot image classification
diff --git a/docs/source/en/tasks/zero_shot_object_detection.mdx b/docs/source/en/tasks/zero_shot_object_detection.md
similarity index 98%
rename from docs/source/en/tasks/zero_shot_object_detection.mdx
rename to docs/source/en/tasks/zero_shot_object_detection.md
index 4ba77647e6..3dfefb3c8b 100644
--- a/docs/source/en/tasks/zero_shot_object_detection.mdx
+++ b/docs/source/en/tasks/zero_shot_object_detection.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # Zero-shot object detection
diff --git a/docs/source/en/tasks_explained.mdx b/docs/source/en/tasks_explained.md
similarity index 99%
rename from docs/source/en/tasks_explained.mdx
rename to docs/source/en/tasks_explained.md
index fba64f4a7a..d453e38e86 100644
--- a/docs/source/en/tasks_explained.mdx
+++ b/docs/source/en/tasks_explained.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # How 🤗 Transformers solve tasks
diff --git a/docs/source/en/testing.mdx b/docs/source/en/testing.md
similarity index 99%
rename from docs/source/en/testing.mdx
rename to docs/source/en/testing.md
index 5adbc8e44d..d3c512e8eb 100644
--- a/docs/source/en/testing.mdx
+++ b/docs/source/en/testing.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # Testing
@@ -217,7 +221,7 @@ Just run the following line to automatically test every docstring example in the
 ```bash 
 pytest --doctest-modules <path_to_file_or_dir>
 ```
-If the file has a markdown extention, you should add the `--doctest-glob="*.mdx"` argument.
+If the file has a markdown extention, you should add the `--doctest-glob="*.md"` argument.
 
 ### Run only modified tests
 
diff --git a/docs/source/en/tf_xla.mdx b/docs/source/en/tf_xla.md
similarity index 98%
rename from docs/source/en/tf_xla.mdx
rename to docs/source/en/tf_xla.md
index 1d9e13e8b3..5f6a360dd8 100644
--- a/docs/source/en/tf_xla.mdx
+++ b/docs/source/en/tf_xla.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # XLA Integration for TensorFlow Models
diff --git a/docs/source/en/tflite.mdx b/docs/source/en/tflite.md
similarity index 94%
rename from docs/source/en/tflite.mdx
rename to docs/source/en/tflite.md
index 23e08478ba..7b7735c992 100644
--- a/docs/source/en/tflite.mdx
+++ b/docs/source/en/tflite.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # Export to TFLite
diff --git a/docs/source/en/tokenizer_summary.mdx b/docs/source/en/tokenizer_summary.md
similarity index 99%
rename from docs/source/en/tokenizer_summary.mdx
rename to docs/source/en/tokenizer_summary.md
index 61099edabe..b13c4e83b8 100644
--- a/docs/source/en/tokenizer_summary.mdx
+++ b/docs/source/en/tokenizer_summary.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # Summary of the tokenizers
diff --git a/docs/source/en/torchscript.mdx b/docs/source/en/torchscript.md
similarity index 98%
rename from docs/source/en/torchscript.mdx
rename to docs/source/en/torchscript.md
index 00497ff7c2..adf34b2ea6 100644
--- a/docs/source/en/torchscript.mdx
+++ b/docs/source/en/torchscript.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # Export to TorchScript
diff --git a/docs/source/en/training.mdx b/docs/source/en/training.md
similarity index 99%
rename from docs/source/en/training.mdx
rename to docs/source/en/training.md
index 24afa907ae..fb4a0b6a27 100644
--- a/docs/source/en/training.mdx
+++ b/docs/source/en/training.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # Fine-tune a pretrained model
diff --git a/docs/source/en/transformers_agents.mdx b/docs/source/en/transformers_agents.md
similarity index 98%
rename from docs/source/en/transformers_agents.mdx
rename to docs/source/en/transformers_agents.md
index e388c3640a..e23015f209 100644
--- a/docs/source/en/transformers_agents.mdx
+++ b/docs/source/en/transformers_agents.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # Transformers Agent
diff --git a/docs/source/en/troubleshooting.mdx b/docs/source/en/troubleshooting.md
similarity index 98%
rename from docs/source/en/troubleshooting.mdx
rename to docs/source/en/troubleshooting.md
index bc3135be8f..29b032dd27 100644
--- a/docs/source/en/troubleshooting.mdx
+++ b/docs/source/en/troubleshooting.md
@@ -12,6 +12,10 @@ distributed under the License is distributed on an "AS IS" BASIS,
 WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 See the License for the specific language governing permissions and
 limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # Troubleshoot
diff --git a/docs/source/es/accelerate.mdx b/docs/source/es/accelerate.md
similarity index 96%
rename from docs/source/es/accelerate.mdx
rename to docs/source/es/accelerate.md
index 6065bc110a..2c4063b7ca 100644
--- a/docs/source/es/accelerate.mdx
+++ b/docs/source/es/accelerate.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # Entrenamiento distribuido con 🤗 Accelerate
diff --git a/docs/source/es/add_new_pipeline.mdx b/docs/source/es/add_new_pipeline.md
similarity index 98%
rename from docs/source/es/add_new_pipeline.mdx
rename to docs/source/es/add_new_pipeline.md
index 8e02207797..5e64c435ab 100644
--- a/docs/source/es/add_new_pipeline.mdx
+++ b/docs/source/es/add_new_pipeline.md
@@ -7,6 +7,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # ¿Cómo puedo crear un pipeline personalizado?
diff --git a/docs/source/es/autoclass_tutorial.mdx b/docs/source/es/autoclass_tutorial.md
similarity index 97%
rename from docs/source/es/autoclass_tutorial.mdx
rename to docs/source/es/autoclass_tutorial.md
index e04a639422..8b3ddd230b 100644
--- a/docs/source/es/autoclass_tutorial.mdx
+++ b/docs/source/es/autoclass_tutorial.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # Carga instancias preentrenadas con un AutoClass
diff --git a/docs/source/es/bertology.mdx b/docs/source/es/bertology.md
similarity index 93%
rename from docs/source/es/bertology.mdx
rename to docs/source/es/bertology.md
index 9a7c488742..ed4e12a8d5 100644
--- a/docs/source/es/bertology.mdx
+++ b/docs/source/es/bertology.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # BERTología
diff --git a/docs/source/es/community.mdx b/docs/source/es/community.md
similarity index 99%
rename from docs/source/es/community.mdx
rename to docs/source/es/community.md
index a34fa30104..261970e6fe 100644
--- a/docs/source/es/community.mdx
+++ b/docs/source/es/community.md
@@ -1,3 +1,7 @@
+<!--⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+-->
+
 # Comunidad
 
 Esta página agrupa los recursos de 🤗 Transformers desarrollados por la comunidad.
diff --git a/docs/source/es/converting_tensorflow_models.mdx b/docs/source/es/converting_tensorflow_models.md
similarity index 97%
rename from docs/source/es/converting_tensorflow_models.mdx
rename to docs/source/es/converting_tensorflow_models.md
index 2ab15e81b2..c7e22bddac 100644
--- a/docs/source/es/converting_tensorflow_models.mdx
+++ b/docs/source/es/converting_tensorflow_models.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # Convertir checkpoints de Tensorflow
diff --git a/docs/source/es/create_a_model.mdx b/docs/source/es/create_a_model.md
similarity index 99%
rename from docs/source/es/create_a_model.mdx
rename to docs/source/es/create_a_model.md
index 99ded53ee6..04014a7b6a 100644
--- a/docs/source/es/create_a_model.mdx
+++ b/docs/source/es/create_a_model.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # Crea una arquitectura personalizada
diff --git a/docs/source/es/custom_models.mdx b/docs/source/es/custom_models.md
similarity index 98%
rename from docs/source/es/custom_models.mdx
rename to docs/source/es/custom_models.md
index 434d59f87d..e616a05605 100644
--- a/docs/source/es/custom_models.mdx
+++ b/docs/source/es/custom_models.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # Compartir modelos personalizados
diff --git a/docs/source/es/debugging.mdx b/docs/source/es/debugging.md
similarity index 98%
rename from docs/source/es/debugging.mdx
rename to docs/source/es/debugging.md
index a709e0407b..3135667530 100644
--- a/docs/source/es/debugging.mdx
+++ b/docs/source/es/debugging.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # Debugging
diff --git a/docs/source/es/fast_tokenizers.mdx b/docs/source/es/fast_tokenizers.md
similarity index 94%
rename from docs/source/es/fast_tokenizers.mdx
rename to docs/source/es/fast_tokenizers.md
index 63b43cc1c4..92b925f67f 100644
--- a/docs/source/es/fast_tokenizers.mdx
+++ b/docs/source/es/fast_tokenizers.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # Usa los tokenizadores de 🤗 Tokenizers
diff --git a/docs/source/es/index.mdx b/docs/source/es/index.md
similarity index 99%
rename from docs/source/es/index.mdx
rename to docs/source/es/index.md
index 49a4f83053..caefdfb7ad 100644
--- a/docs/source/es/index.mdx
+++ b/docs/source/es/index.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # 🤗 Transformers
diff --git a/docs/source/es/installation.mdx b/docs/source/es/installation.md
similarity index 98%
rename from docs/source/es/installation.mdx
rename to docs/source/es/installation.md
index 01b9d81409..0eb2dcb03a 100644
--- a/docs/source/es/installation.mdx
+++ b/docs/source/es/installation.md
@@ -12,6 +12,10 @@ distributed under the License is distributed on an "AS IS" BASIS,
 WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 See the License for the specific language governing permissions and
 limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # Instalación
diff --git a/docs/source/es/model_sharing.mdx b/docs/source/es/model_sharing.md
similarity index 98%
rename from docs/source/es/model_sharing.mdx
rename to docs/source/es/model_sharing.md
index 06029880fb..46e1ee07a9 100644
--- a/docs/source/es/model_sharing.mdx
+++ b/docs/source/es/model_sharing.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # Compartir un modelo
diff --git a/docs/source/es/multilingual.mdx b/docs/source/es/multilingual.md
similarity index 98%
rename from docs/source/es/multilingual.mdx
rename to docs/source/es/multilingual.md
index 4849416a44..fa60cac68c 100644
--- a/docs/source/es/multilingual.mdx
+++ b/docs/source/es/multilingual.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # Modelos multilingües para inferencia
diff --git a/docs/source/es/philosophy.mdx b/docs/source/es/philosophy.md
similarity index 97%
rename from docs/source/es/philosophy.mdx
rename to docs/source/es/philosophy.md
index 65e9a2c67a..4054ac0ae5 100644
--- a/docs/source/es/philosophy.mdx
+++ b/docs/source/es/philosophy.md
@@ -7,6 +7,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 
 Al menos que sea requrido por la ley aplicable o acordado por escrito, el software distribuido bajo la Licencia es distribuido sobre una BASE "AS IS", SIN GARANTIAS O CONDICIONES DE
 NINGÚN TIPO. Ver la Licencia para el idioma específico que rige los permisos y limitaciones bajo la Licencia.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # Filosofía
diff --git a/docs/source/es/pipeline_tutorial.mdx b/docs/source/es/pipeline_tutorial.md
similarity index 97%
rename from docs/source/es/pipeline_tutorial.mdx
rename to docs/source/es/pipeline_tutorial.md
index af202758eb..0f77c3c3db 100644
--- a/docs/source/es/pipeline_tutorial.mdx
+++ b/docs/source/es/pipeline_tutorial.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # Pipelines para inferencia
diff --git a/docs/source/es/pr_checks.mdx b/docs/source/es/pr_checks.md
similarity index 97%
rename from docs/source/es/pr_checks.mdx
rename to docs/source/es/pr_checks.md
index 283f025a81..ba67e85306 100644
--- a/docs/source/es/pr_checks.mdx
+++ b/docs/source/es/pr_checks.md
@@ -12,6 +12,10 @@ distributed under the License is distributed on an "AS IS" BASIS,
 WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 See the License for the specific language governing permissions and
 limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # Verificaciones en un Pull Request
diff --git a/docs/source/es/preprocessing.mdx b/docs/source/es/preprocessing.md
similarity index 99%
rename from docs/source/es/preprocessing.mdx
rename to docs/source/es/preprocessing.md
index 869f90c417..f4eec4862b 100644
--- a/docs/source/es/preprocessing.mdx
+++ b/docs/source/es/preprocessing.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # Preprocesamiento
diff --git a/docs/source/es/quicktour.mdx b/docs/source/es/quicktour.md
similarity index 99%
rename from docs/source/es/quicktour.mdx
rename to docs/source/es/quicktour.md
index 9a3e52e8c1..a674adf5cc 100644
--- a/docs/source/es/quicktour.mdx
+++ b/docs/source/es/quicktour.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # Tour rápido
diff --git a/docs/source/es/run_scripts.mdx b/docs/source/es/run_scripts.md
similarity index 99%
rename from docs/source/es/run_scripts.mdx
rename to docs/source/es/run_scripts.md
index d0ab716f80..a66fd1e47e 100644
--- a/docs/source/es/run_scripts.mdx
+++ b/docs/source/es/run_scripts.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # Entrenamiento con scripts
diff --git a/docs/source/es/sagemaker.mdx b/docs/source/es/sagemaker.md
similarity index 87%
rename from docs/source/es/sagemaker.mdx
rename to docs/source/es/sagemaker.md
index 491d93e10d..a874aefe76 100644
--- a/docs/source/es/sagemaker.mdx
+++ b/docs/source/es/sagemaker.md
@@ -12,6 +12,10 @@ distributed under the License is distributed on an "AS IS" BASIS,
 WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 See the License for the specific language governing permissions and
 limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # Ejecutar el entrenamiento en Amazon SageMaker
diff --git a/docs/source/es/serialization.mdx b/docs/source/es/serialization.md
similarity index 99%
rename from docs/source/es/serialization.mdx
rename to docs/source/es/serialization.md
index 2815734bfa..9c24ba72f3 100644
--- a/docs/source/es/serialization.mdx
+++ b/docs/source/es/serialization.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # Exportar modelos 🤗 Transformers
diff --git a/docs/source/es/tasks/asr.mdx b/docs/source/es/tasks/asr.md
similarity index 98%
rename from docs/source/es/tasks/asr.mdx
rename to docs/source/es/tasks/asr.md
index f3747a332d..850bdfd711 100644
--- a/docs/source/es/tasks/asr.mdx
+++ b/docs/source/es/tasks/asr.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # Reconocimiento automático del habla
diff --git a/docs/source/es/tasks/image_classification.mdx b/docs/source/es/tasks/image_classification.md
similarity index 97%
rename from docs/source/es/tasks/image_classification.mdx
rename to docs/source/es/tasks/image_classification.md
index 9b8b03207d..ef67131d73 100644
--- a/docs/source/es/tasks/image_classification.mdx
+++ b/docs/source/es/tasks/image_classification.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # Clasificación de imágenes
diff --git a/docs/source/es/tasks/language_modeling.mdx b/docs/source/es/tasks/language_modeling.md
similarity index 99%
rename from docs/source/es/tasks/language_modeling.mdx
rename to docs/source/es/tasks/language_modeling.md
index 565185072a..8d2ba49d0d 100644
--- a/docs/source/es/tasks/language_modeling.mdx
+++ b/docs/source/es/tasks/language_modeling.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # Modelado de lenguaje
diff --git a/docs/source/es/tasks/multiple_choice.mdx b/docs/source/es/tasks/multiple_choice.md
similarity index 98%
rename from docs/source/es/tasks/multiple_choice.mdx
rename to docs/source/es/tasks/multiple_choice.md
index 2ece0969bf..8391dcbdd5 100644
--- a/docs/source/es/tasks/multiple_choice.mdx
+++ b/docs/source/es/tasks/multiple_choice.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # Selección múltiple
diff --git a/docs/source/es/tasks/question_answering.mdx b/docs/source/es/tasks/question_answering.md
similarity index 98%
rename from docs/source/es/tasks/question_answering.mdx
rename to docs/source/es/tasks/question_answering.md
index d599fa8f1a..2aa896142e 100644
--- a/docs/source/es/tasks/question_answering.mdx
+++ b/docs/source/es/tasks/question_answering.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # Respuesta a preguntas
diff --git a/docs/source/es/tasks/summarization.mdx b/docs/source/es/tasks/summarization.md
similarity index 98%
rename from docs/source/es/tasks/summarization.mdx
rename to docs/source/es/tasks/summarization.md
index 066ac288b4..b545e4216e 100644
--- a/docs/source/es/tasks/summarization.mdx
+++ b/docs/source/es/tasks/summarization.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # Generación de resúmenes
diff --git a/docs/source/es/training.mdx b/docs/source/es/training.md
similarity index 98%
rename from docs/source/es/training.mdx
rename to docs/source/es/training.md
index 6a7f408920..7b7b0657bd 100644
--- a/docs/source/es/training.mdx
+++ b/docs/source/es/training.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # Fine-tuning a un modelo pre-entrenado
diff --git a/docs/source/fr/in_translation.md b/docs/source/fr/in_translation.md
new file mode 100644
index 0000000000..910559ef6c
--- /dev/null
+++ b/docs/source/fr/in_translation.md
@@ -0,0 +1,5 @@
+<!--⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+-->
+
+# Traduction en cours. 
\ No newline at end of file
diff --git a/docs/source/fr/in_translation.mdx b/docs/source/fr/in_translation.mdx
deleted file mode 100644
index 619f76420b..0000000000
--- a/docs/source/fr/in_translation.mdx
+++ /dev/null
@@ -1 +0,0 @@
-# Traduction en cours. 
\ No newline at end of file
diff --git a/docs/source/fr/index.mdx b/docs/source/fr/index.md
similarity index 99%
rename from docs/source/fr/index.mdx
rename to docs/source/fr/index.md
index 63a3e8391f..f18ad8e57c 100644
--- a/docs/source/fr/index.mdx
+++ b/docs/source/fr/index.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # 🤗 Transformers
diff --git a/docs/source/fr/quicktour.mdx b/docs/source/fr/quicktour.md
similarity index 99%
rename from docs/source/fr/quicktour.mdx
rename to docs/source/fr/quicktour.md
index d7d00e31dd..5d5387cfdd 100644
--- a/docs/source/fr/quicktour.mdx
+++ b/docs/source/fr/quicktour.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # Visite rapide
diff --git a/docs/source/it/accelerate.mdx b/docs/source/it/accelerate.md
similarity index 96%
rename from docs/source/it/accelerate.mdx
rename to docs/source/it/accelerate.md
index 20dc1a7ff9..3114613a9a 100644
--- a/docs/source/it/accelerate.mdx
+++ b/docs/source/it/accelerate.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # Allenamento distribuito con 🤗 Accelerate
diff --git a/docs/source/it/add_new_model.mdx b/docs/source/it/add_new_model.md
similarity index 99%
rename from docs/source/it/add_new_model.mdx
rename to docs/source/it/add_new_model.md
index 8dce90a816..3ee22e804a 100644
--- a/docs/source/it/add_new_model.mdx
+++ b/docs/source/it/add_new_model.md
@@ -7,6 +7,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # Come aggiungere un modello a 🤗 Transformers?
diff --git a/docs/source/it/add_new_pipeline.mdx b/docs/source/it/add_new_pipeline.md
similarity index 98%
rename from docs/source/it/add_new_pipeline.mdx
rename to docs/source/it/add_new_pipeline.md
index cf9acd2902..adc1c3651a 100644
--- a/docs/source/it/add_new_pipeline.mdx
+++ b/docs/source/it/add_new_pipeline.md
@@ -7,6 +7,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # Come creare una pipeline personalizzata?
diff --git a/docs/source/it/autoclass_tutorial.mdx b/docs/source/it/autoclass_tutorial.md
similarity index 97%
rename from docs/source/it/autoclass_tutorial.mdx
rename to docs/source/it/autoclass_tutorial.md
index 88dd6cad6c..51621d0983 100644
--- a/docs/source/it/autoclass_tutorial.mdx
+++ b/docs/source/it/autoclass_tutorial.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # Carica istanze pre-allenate con AutoClass
diff --git a/docs/source/it/big_models.mdx b/docs/source/it/big_models.md
similarity index 97%
rename from docs/source/it/big_models.mdx
rename to docs/source/it/big_models.md
index 56a0fa6fea..cd0fd9017d 100644
--- a/docs/source/it/big_models.mdx
+++ b/docs/source/it/big_models.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # Istanziare un big model
diff --git a/docs/source/it/community.mdx b/docs/source/it/community.md
similarity index 99%
rename from docs/source/it/community.mdx
rename to docs/source/it/community.md
index 530e132014..2f3c0c8a82 100644
--- a/docs/source/it/community.mdx
+++ b/docs/source/it/community.md
@@ -1,4 +1,8 @@
-# Comunità
+<!--⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+-->
+
+# Comunità
 
 Questa pagina raggruppa le risorse sviluppate dalla comunità riguardo 🤗 Transformers.
 
diff --git a/docs/source/it/converting_tensorflow_models.mdx b/docs/source/it/converting_tensorflow_models.md
similarity index 97%
rename from docs/source/it/converting_tensorflow_models.mdx
rename to docs/source/it/converting_tensorflow_models.md
index b9b30a315c..0439863635 100644
--- a/docs/source/it/converting_tensorflow_models.mdx
+++ b/docs/source/it/converting_tensorflow_models.md
@@ -5,6 +5,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # Convertire checkpoint di Tensorflow
diff --git a/docs/source/it/create_a_model.mdx b/docs/source/it/create_a_model.md
similarity index 98%
rename from docs/source/it/create_a_model.mdx
rename to docs/source/it/create_a_model.md
index 6e11f3f1d0..c32040d7d3 100644
--- a/docs/source/it/create_a_model.mdx
+++ b/docs/source/it/create_a_model.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # Crea un'architettura personalizzata 
diff --git a/docs/source/it/custom_models.mdx b/docs/source/it/custom_models.md
similarity index 98%
rename from docs/source/it/custom_models.mdx
rename to docs/source/it/custom_models.md
index b4b0302e29..b0cdf4cd7b 100644
--- a/docs/source/it/custom_models.mdx
+++ b/docs/source/it/custom_models.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # Condividere modelli personalizzati
diff --git a/docs/source/it/debugging.mdx b/docs/source/it/debugging.md
similarity index 98%
rename from docs/source/it/debugging.mdx
rename to docs/source/it/debugging.md
index 5b392489ea..5c1dab51bd 100644
--- a/docs/source/it/debugging.mdx
+++ b/docs/source/it/debugging.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # Debugging
diff --git a/docs/source/it/index.mdx b/docs/source/it/index.md
similarity index 99%
rename from docs/source/it/index.mdx
rename to docs/source/it/index.md
index 4c050bfe52..5c7d22c1e6 100644
--- a/docs/source/it/index.mdx
+++ b/docs/source/it/index.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # 🤗 Transformers
diff --git a/docs/source/it/installation.mdx b/docs/source/it/installation.md
similarity index 98%
rename from docs/source/it/installation.mdx
rename to docs/source/it/installation.md
index 1ff47c110c..4f884f80d9 100644
--- a/docs/source/it/installation.mdx
+++ b/docs/source/it/installation.md
@@ -12,6 +12,10 @@ distributed under the License is distributed on an "AS IS" BASIS,
 WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 See the License for the specific language governing permissions and
 limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # Installazione
diff --git a/docs/source/it/migration.mdx b/docs/source/it/migration.md
similarity index 98%
rename from docs/source/it/migration.mdx
rename to docs/source/it/migration.md
index 92622787c6..3b3b71da4d 100644
--- a/docs/source/it/migration.mdx
+++ b/docs/source/it/migration.md
@@ -12,6 +12,10 @@ distribuito con la Licenza è distribuito su BASE "COSÌ COM'È",
 SENZA GARANZIE O CONDIZIONI DI ALCUN TIPO, espresse o implicite. 
 Per la lingua specifica vedi la Licenza che regola le autorizzazioni e 
 le limitazioni ai sensi della STESSA. 
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 --> 
 
 # Migrazione da pacchetti precedenti 
diff --git a/docs/source/it/model_sharing.mdx b/docs/source/it/model_sharing.md
similarity index 98%
rename from docs/source/it/model_sharing.mdx
rename to docs/source/it/model_sharing.md
index 9e1ca9588a..351cf57bf9 100644
--- a/docs/source/it/model_sharing.mdx
+++ b/docs/source/it/model_sharing.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # Condividi un modello
diff --git a/docs/source/it/multilingual.mdx b/docs/source/it/multilingual.md
similarity index 98%
rename from docs/source/it/multilingual.mdx
rename to docs/source/it/multilingual.md
index a8ccec97d0..889c620ab2 100644
--- a/docs/source/it/multilingual.mdx
+++ b/docs/source/it/multilingual.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # Modelli multilingue per l'inferenza
diff --git a/docs/source/it/perf_hardware.mdx b/docs/source/it/perf_hardware.md
similarity index 97%
rename from docs/source/it/perf_hardware.mdx
rename to docs/source/it/perf_hardware.md
index 0bfdbc8fe6..a579362e2b 100644
--- a/docs/source/it/perf_hardware.mdx
+++ b/docs/source/it/perf_hardware.md
@@ -12,6 +12,10 @@ distributed under the License is distributed on an "AS IS" BASIS,
 WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 See the License for the specific language governing permissions and
 limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 
diff --git a/docs/source/it/perf_infer_cpu.mdx b/docs/source/it/perf_infer_cpu.md
similarity index 96%
rename from docs/source/it/perf_infer_cpu.mdx
rename to docs/source/it/perf_infer_cpu.md
index 1423b8f055..baae51a5a9 100644
--- a/docs/source/it/perf_infer_cpu.mdx
+++ b/docs/source/it/perf_infer_cpu.md
@@ -7,6 +7,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # Inferenza Efficiente su CPU
diff --git a/docs/source/it/perf_infer_gpu_many.mdx b/docs/source/it/perf_infer_gpu_many.md
similarity index 88%
rename from docs/source/it/perf_infer_gpu_many.mdx
rename to docs/source/it/perf_infer_gpu_many.md
index 5eeefa907d..b78cb34e1d 100644
--- a/docs/source/it/perf_infer_gpu_many.mdx
+++ b/docs/source/it/perf_infer_gpu_many.md
@@ -7,6 +7,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # Inferenza Efficiente su GPU Multiple
diff --git a/docs/source/it/perf_infer_gpu_one.mdx b/docs/source/it/perf_infer_gpu_one.md
similarity index 97%
rename from docs/source/it/perf_infer_gpu_one.mdx
rename to docs/source/it/perf_infer_gpu_one.md
index 60df055153..9acbed1d0f 100644
--- a/docs/source/it/perf_infer_gpu_one.mdx
+++ b/docs/source/it/perf_infer_gpu_one.md
@@ -7,6 +7,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # Inferenza efficiente su GPU singola
diff --git a/docs/source/it/perf_infer_special.mdx b/docs/source/it/perf_infer_special.md
similarity index 81%
rename from docs/source/it/perf_infer_special.mdx
rename to docs/source/it/perf_infer_special.md
index 1e92190d19..3e2c0a5c28 100644
--- a/docs/source/it/perf_infer_special.mdx
+++ b/docs/source/it/perf_infer_special.md
@@ -7,6 +7,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # Inferenza su Hardware Specializzato
diff --git a/docs/source/it/perf_train_cpu.mdx b/docs/source/it/perf_train_cpu.md
similarity index 95%
rename from docs/source/it/perf_train_cpu.mdx
rename to docs/source/it/perf_train_cpu.md
index bf9b265ba3..c91baeec88 100644
--- a/docs/source/it/perf_train_cpu.mdx
+++ b/docs/source/it/perf_train_cpu.md
@@ -7,6 +7,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # Addestramento efficiente su CPU
diff --git a/docs/source/it/perf_train_cpu_many.mdx b/docs/source/it/perf_train_cpu_many.md
similarity index 97%
rename from docs/source/it/perf_train_cpu_many.mdx
rename to docs/source/it/perf_train_cpu_many.md
index abe99b27f8..2fb10ee4ba 100644
--- a/docs/source/it/perf_train_cpu_many.mdx
+++ b/docs/source/it/perf_train_cpu_many.md
@@ -7,6 +7,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # Addestramento effciente su multiple CPU
diff --git a/docs/source/it/perf_train_special.mdx b/docs/source/it/perf_train_special.md
similarity index 86%
rename from docs/source/it/perf_train_special.mdx
rename to docs/source/it/perf_train_special.md
index 22ea6d73e3..afe05d801d 100644
--- a/docs/source/it/perf_train_special.mdx
+++ b/docs/source/it/perf_train_special.md
@@ -7,6 +7,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # Addestramento su Hardware Specializzato
diff --git a/docs/source/it/perf_train_tpu.mdx b/docs/source/it/perf_train_tpu.md
similarity index 85%
rename from docs/source/it/perf_train_tpu.mdx
rename to docs/source/it/perf_train_tpu.md
index 395caebcd0..663f83c499 100644
--- a/docs/source/it/perf_train_tpu.mdx
+++ b/docs/source/it/perf_train_tpu.md
@@ -7,6 +7,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # Addestramento su TPU
diff --git a/docs/source/it/pipeline_tutorial.mdx b/docs/source/it/pipeline_tutorial.md
similarity index 97%
rename from docs/source/it/pipeline_tutorial.mdx
rename to docs/source/it/pipeline_tutorial.md
index 6434716450..056282b164 100644
--- a/docs/source/it/pipeline_tutorial.mdx
+++ b/docs/source/it/pipeline_tutorial.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # Pipeline per l'inferenza
diff --git a/docs/source/it/pr_checks.mdx b/docs/source/it/pr_checks.md
similarity index 97%
rename from docs/source/it/pr_checks.mdx
rename to docs/source/it/pr_checks.md
index d7541d59f0..caa5fe3296 100644
--- a/docs/source/it/pr_checks.mdx
+++ b/docs/source/it/pr_checks.md
@@ -12,6 +12,10 @@ distributed under the License is distributed on an "AS IS" BASIS,
 WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 See the License for the specific language governing permissions and
 limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # Controlli su una Pull Request
diff --git a/docs/source/it/preprocessing.mdx b/docs/source/it/preprocessing.md
similarity index 99%
rename from docs/source/it/preprocessing.mdx
rename to docs/source/it/preprocessing.md
index a57ff9df91..94578dfe16 100644
--- a/docs/source/it/preprocessing.mdx
+++ b/docs/source/it/preprocessing.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # Preprocess
diff --git a/docs/source/it/quicktour.mdx b/docs/source/it/quicktour.md
similarity index 99%
rename from docs/source/it/quicktour.mdx
rename to docs/source/it/quicktour.md
index 2378edd2c2..2ec450e238 100644
--- a/docs/source/it/quicktour.mdx
+++ b/docs/source/it/quicktour.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # Quick tour
diff --git a/docs/source/it/run_scripts.mdx b/docs/source/it/run_scripts.md
similarity index 99%
rename from docs/source/it/run_scripts.mdx
rename to docs/source/it/run_scripts.md
index 3ffd58a628..327eb9374d 100644
--- a/docs/source/it/run_scripts.mdx
+++ b/docs/source/it/run_scripts.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # Addestramento con script
diff --git a/docs/source/it/serialization.mdx b/docs/source/it/serialization.md
similarity index 99%
rename from docs/source/it/serialization.mdx
rename to docs/source/it/serialization.md
index 1dde00f429..0067f1a3c5 100644
--- a/docs/source/it/serialization.mdx
+++ b/docs/source/it/serialization.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # Esporta modelli 🤗 Transformers 
diff --git a/docs/source/it/training.mdx b/docs/source/it/training.md
similarity index 98%
rename from docs/source/it/training.mdx
rename to docs/source/it/training.md
index 68f6434bbb..be0883f07b 100644
--- a/docs/source/it/training.mdx
+++ b/docs/source/it/training.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # Fine-tuning di un modello pre-addestrato
diff --git a/docs/source/ja/accelerate.mdx b/docs/source/ja/accelerate.md
similarity index 96%
rename from docs/source/ja/accelerate.mdx
rename to docs/source/ja/accelerate.md
index 823ed0dcf7..73e45b9cd3 100644
--- a/docs/source/ja/accelerate.mdx
+++ b/docs/source/ja/accelerate.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # 🤗 Accelerate を用いた分散学習
diff --git a/docs/source/ja/index.mdx b/docs/source/ja/index.md
similarity index 99%
rename from docs/source/ja/index.mdx
rename to docs/source/ja/index.md
index f55a3fd42a..364a3b34ca 100644
--- a/docs/source/ja/index.mdx
+++ b/docs/source/ja/index.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # 🤗 Transformers
diff --git a/docs/source/ja/installation.mdx b/docs/source/ja/installation.md
similarity index 98%
rename from docs/source/ja/installation.mdx
rename to docs/source/ja/installation.md
index 0ae6cad52d..3b8646672e 100644
--- a/docs/source/ja/installation.mdx
+++ b/docs/source/ja/installation.md
@@ -12,6 +12,10 @@ distributed under the License is distributed on an "AS IS" BASIS,
 WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 See the License for the specific language governing permissions and
 limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # インストール
diff --git a/docs/source/ja/multilingual.mdx b/docs/source/ja/multilingual.md
similarity index 98%
rename from docs/source/ja/multilingual.mdx
rename to docs/source/ja/multilingual.md
index a5ccc18385..86dabb9463 100644
--- a/docs/source/ja/multilingual.mdx
+++ b/docs/source/ja/multilingual.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # 推論のための多言語モデル
diff --git a/docs/source/ko/accelerate.mdx b/docs/source/ko/accelerate.md
similarity index 96%
rename from docs/source/ko/accelerate.mdx
rename to docs/source/ko/accelerate.md
index e79b7a9bcf..0ef8957de3 100644
--- a/docs/source/ko/accelerate.mdx
+++ b/docs/source/ko/accelerate.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # 🤗 Accelerate를 활용한 분산 학습[[distributed-training-with-accelerate]]
diff --git a/docs/source/ko/attention.mdx b/docs/source/ko/attention.md
similarity index 96%
rename from docs/source/ko/attention.mdx
rename to docs/source/ko/attention.md
index 5ba05938e1..8f82a4b851 100644
--- a/docs/source/ko/attention.mdx
+++ b/docs/source/ko/attention.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # 어텐션 메커니즘[[attention_mechanisms]]
diff --git a/docs/source/ko/autoclass_tutorial.mdx b/docs/source/ko/autoclass_tutorial.md
similarity index 97%
rename from docs/source/ko/autoclass_tutorial.mdx
rename to docs/source/ko/autoclass_tutorial.md
index dfbfda2d51..9ecfd9c201 100644
--- a/docs/source/ko/autoclass_tutorial.mdx
+++ b/docs/source/ko/autoclass_tutorial.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # AutoClass로 사전 학습된 인스턴스 로드[[load-pretrained-instances-with-an-autoclass]]
diff --git a/docs/source/ko/bertology.mdx b/docs/source/ko/bertology.md
similarity index 93%
rename from docs/source/ko/bertology.mdx
rename to docs/source/ko/bertology.md
index 33b00b2af4..7b4f3dc4c4 100644
--- a/docs/source/ko/bertology.mdx
+++ b/docs/source/ko/bertology.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # BERTology
diff --git a/docs/source/ko/create_a_model.mdx b/docs/source/ko/create_a_model.md
similarity index 99%
rename from docs/source/ko/create_a_model.mdx
rename to docs/source/ko/create_a_model.md
index 15b14583c8..8c7be3291e 100644
--- a/docs/source/ko/create_a_model.mdx
+++ b/docs/source/ko/create_a_model.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # 맞춤형 아키텍처 만들기[[create-a-custom-architecture]]
diff --git a/docs/source/ko/custom_models.mdx b/docs/source/ko/custom_models.md
similarity index 99%
rename from docs/source/ko/custom_models.mdx
rename to docs/source/ko/custom_models.md
index 6e9d91fcda..72dad7caaf 100644
--- a/docs/source/ko/custom_models.mdx
+++ b/docs/source/ko/custom_models.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # 사용자 정의 모델 공유하기[[sharing-custom-models]]
diff --git a/docs/source/ko/fast_tokenizers.mdx b/docs/source/ko/fast_tokenizers.md
similarity index 95%
rename from docs/source/ko/fast_tokenizers.mdx
rename to docs/source/ko/fast_tokenizers.md
index bef75686ec..a6d1f14283 100644
--- a/docs/source/ko/fast_tokenizers.mdx
+++ b/docs/source/ko/fast_tokenizers.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # 🤗 Tokenizers 라이브러리의 토크나이저 사용하기[[use-tokenizers-from-tokenizers]]
diff --git a/docs/source/ko/in_translation.md b/docs/source/ko/in_translation.md
new file mode 100644
index 0000000000..61ff1426a4
--- /dev/null
+++ b/docs/source/ko/in_translation.md
@@ -0,0 +1,5 @@
+<!--⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+-->
+
+# 열심히 번역 중입니다. 조금 이따 만나요!
\ No newline at end of file
diff --git a/docs/source/ko/in_translation.mdx b/docs/source/ko/in_translation.mdx
deleted file mode 100644
index ead9061833..0000000000
--- a/docs/source/ko/in_translation.mdx
+++ /dev/null
@@ -1 +0,0 @@
-# 열심히 번역 중입니다. 조금 이따 만나요!
\ No newline at end of file
diff --git a/docs/source/ko/index.mdx b/docs/source/ko/index.md
similarity index 99%
rename from docs/source/ko/index.mdx
rename to docs/source/ko/index.md
index 5a6428d694..f0ec9ae1b8 100644
--- a/docs/source/ko/index.mdx
+++ b/docs/source/ko/index.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # 🤗 Transformers
diff --git a/docs/source/ko/installation.mdx b/docs/source/ko/installation.md
similarity index 98%
rename from docs/source/ko/installation.mdx
rename to docs/source/ko/installation.md
index 6ca9a7b313..cd72d8c6bc 100644
--- a/docs/source/ko/installation.mdx
+++ b/docs/source/ko/installation.md
@@ -12,6 +12,10 @@ distributed under the License is distributed on an "AS IS" BASIS,
 WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 See the License for the specific language governing permissions and
 limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # 설치방법[[installation]]
diff --git a/docs/source/ko/model_sharing.mdx b/docs/source/ko/model_sharing.md
similarity index 98%
rename from docs/source/ko/model_sharing.mdx
rename to docs/source/ko/model_sharing.md
index 3dcd7a0ebc..ed6836e8de 100644
--- a/docs/source/ko/model_sharing.mdx
+++ b/docs/source/ko/model_sharing.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # 모델 공유하기[[share-a-model]]
diff --git a/docs/source/ko/multilingual.mdx b/docs/source/ko/multilingual.md
similarity index 98%
rename from docs/source/ko/multilingual.mdx
rename to docs/source/ko/multilingual.md
index 5483ac1318..2862bd9838 100644
--- a/docs/source/ko/multilingual.mdx
+++ b/docs/source/ko/multilingual.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # 다국어 모델 추론하기[[multilingual-models-for-inference]]
diff --git a/docs/source/ko/pad_truncation.mdx b/docs/source/ko/pad_truncation.md
similarity index 97%
rename from docs/source/ko/pad_truncation.mdx
rename to docs/source/ko/pad_truncation.md
index 6fd7ccee2f..6aa8b99b1d 100644
--- a/docs/source/ko/pad_truncation.mdx
+++ b/docs/source/ko/pad_truncation.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # 패딩과 잘라내기[[padding-and-truncation]]
diff --git a/docs/source/ko/pipeline_tutorial.mdx b/docs/source/ko/pipeline_tutorial.md
similarity index 98%
rename from docs/source/ko/pipeline_tutorial.mdx
rename to docs/source/ko/pipeline_tutorial.md
index 769122d3a0..4c32db756f 100644
--- a/docs/source/ko/pipeline_tutorial.mdx
+++ b/docs/source/ko/pipeline_tutorial.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # 추론을 위한 Pipeline[[pipelines-for-inference]]
diff --git a/docs/source/ko/preprocessing.mdx b/docs/source/ko/preprocessing.md
similarity index 99%
rename from docs/source/ko/preprocessing.mdx
rename to docs/source/ko/preprocessing.md
index 9b83d7bb29..a7597f23a0 100644
--- a/docs/source/ko/preprocessing.mdx
+++ b/docs/source/ko/preprocessing.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # 전처리[[preprocess]]
diff --git a/docs/source/ko/quicktour.mdx b/docs/source/ko/quicktour.md
similarity index 99%
rename from docs/source/ko/quicktour.mdx
rename to docs/source/ko/quicktour.md
index dc50d6a938..d8c4038af9 100644
--- a/docs/source/ko/quicktour.mdx
+++ b/docs/source/ko/quicktour.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # 둘러보기[[quick-tour]]
diff --git a/docs/source/ko/run_scripts.mdx b/docs/source/ko/run_scripts.md
similarity index 99%
rename from docs/source/ko/run_scripts.mdx
rename to docs/source/ko/run_scripts.md
index e829198b36..c1af167718 100644
--- a/docs/source/ko/run_scripts.mdx
+++ b/docs/source/ko/run_scripts.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # 스크립트로 실행하기[[train-with-a-script]]
diff --git a/docs/source/ko/sagemaker.mdx b/docs/source/ko/sagemaker.md
similarity index 87%
rename from docs/source/ko/sagemaker.mdx
rename to docs/source/ko/sagemaker.md
index 882dc2fd77..f612435d3c 100644
--- a/docs/source/ko/sagemaker.mdx
+++ b/docs/source/ko/sagemaker.md
@@ -12,6 +12,10 @@ distributed under the License is distributed on an "AS IS" BASIS,
 WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 See the License for the specific language governing permissions and
 limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # Amazon SageMaker에서 학습 실행하기[[run-training-on-amazon-sagemaker]]
diff --git a/docs/source/ko/serialization.mdx b/docs/source/ko/serialization.md
similarity index 99%
rename from docs/source/ko/serialization.mdx
rename to docs/source/ko/serialization.md
index a72a9472eb..e3d06deac8 100644
--- a/docs/source/ko/serialization.mdx
+++ b/docs/source/ko/serialization.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # ONNX로 내보내기[[export-to-onnx]]
diff --git a/docs/source/ko/task_summary.mdx b/docs/source/ko/task_summary.md
similarity index 99%
rename from docs/source/ko/task_summary.mdx
rename to docs/source/ko/task_summary.md
index b495e35682..dbebf38760 100644
--- a/docs/source/ko/task_summary.mdx
+++ b/docs/source/ko/task_summary.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # 🤗 Transformers로 할 수 있는 것[[what__transformers_can_do]]
diff --git a/docs/source/ko/tasks/asr.mdx b/docs/source/ko/tasks/asr.md
similarity index 98%
rename from docs/source/ko/tasks/asr.mdx
rename to docs/source/ko/tasks/asr.md
index ec84bd4e8f..47a568ecf0 100644
--- a/docs/source/ko/tasks/asr.mdx
+++ b/docs/source/ko/tasks/asr.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # 자동 음성 인식[[automatic-speech-recognition]]
diff --git a/docs/source/ko/tasks/image_captioning.mdx b/docs/source/ko/tasks/image_captioning.md
similarity index 98%
rename from docs/source/ko/tasks/image_captioning.mdx
rename to docs/source/ko/tasks/image_captioning.md
index a7c317a797..0521db0dc9 100644
--- a/docs/source/ko/tasks/image_captioning.mdx
+++ b/docs/source/ko/tasks/image_captioning.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 
diff --git a/docs/source/ko/tasks/image_classification.mdx b/docs/source/ko/tasks/image_classification.md
similarity index 99%
rename from docs/source/ko/tasks/image_classification.mdx
rename to docs/source/ko/tasks/image_classification.md
index 3815f8708e..031e01ea5c 100644
--- a/docs/source/ko/tasks/image_classification.mdx
+++ b/docs/source/ko/tasks/image_classification.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # 이미지 분류[[image-classification]]
diff --git a/docs/source/ko/tasks/language_modeling.mdx b/docs/source/ko/tasks/language_modeling.md
similarity index 99%
rename from docs/source/ko/tasks/language_modeling.mdx
rename to docs/source/ko/tasks/language_modeling.md
index e5261d1813..ba540825c2 100644
--- a/docs/source/ko/tasks/language_modeling.mdx
+++ b/docs/source/ko/tasks/language_modeling.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # 인과 언어 모델링[[causal-language-modeling]]
diff --git a/docs/source/ko/tasks/masked_language_modeling.mdx b/docs/source/ko/tasks/masked_language_modeling.md
similarity index 99%
rename from docs/source/ko/tasks/masked_language_modeling.mdx
rename to docs/source/ko/tasks/masked_language_modeling.md
index 9eb375d3b8..d22d439dbd 100644
--- a/docs/source/ko/tasks/masked_language_modeling.mdx
+++ b/docs/source/ko/tasks/masked_language_modeling.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # 마스킹된 언어 모델링(Masked language modeling)[[masked-language-modeling]]
diff --git a/docs/source/ko/tasks/monocular_depth_estimation.mdx b/docs/source/ko/tasks/monocular_depth_estimation.md
similarity index 97%
rename from docs/source/ko/tasks/monocular_depth_estimation.mdx
rename to docs/source/ko/tasks/monocular_depth_estimation.md
index 2ccadd2fd3..e02dd5466b 100644
--- a/docs/source/ko/tasks/monocular_depth_estimation.mdx
+++ b/docs/source/ko/tasks/monocular_depth_estimation.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # 단일 영상 기반 깊이 추정[[depth-estimation-pipeline]]
diff --git a/docs/source/ko/tasks/multiple_choice.mdx b/docs/source/ko/tasks/multiple_choice.md
similarity index 99%
rename from docs/source/ko/tasks/multiple_choice.mdx
rename to docs/source/ko/tasks/multiple_choice.md
index 9a259ee77a..c174ca632f 100644
--- a/docs/source/ko/tasks/multiple_choice.mdx
+++ b/docs/source/ko/tasks/multiple_choice.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # 객관식 문제[[multiple-choice]]
diff --git a/docs/source/ko/tasks/object_detection.mdx b/docs/source/ko/tasks/object_detection.md
similarity index 99%
rename from docs/source/ko/tasks/object_detection.mdx
rename to docs/source/ko/tasks/object_detection.md
index 9d65da72fb..f29ca5d61b 100644
--- a/docs/source/ko/tasks/object_detection.mdx
+++ b/docs/source/ko/tasks/object_detection.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # 객체 탐지 [[object-detection]]
diff --git a/docs/source/ko/tasks/question_answering.mdx b/docs/source/ko/tasks/question_answering.md
similarity index 99%
rename from docs/source/ko/tasks/question_answering.mdx
rename to docs/source/ko/tasks/question_answering.md
index 602d1b71be..4b218ccce2 100644
--- a/docs/source/ko/tasks/question_answering.mdx
+++ b/docs/source/ko/tasks/question_answering.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # 질의 응답(Question Answering)[[question-answering]]
diff --git a/docs/source/ko/tasks/sequence_classification.mdx b/docs/source/ko/tasks/sequence_classification.md
similarity index 99%
rename from docs/source/ko/tasks/sequence_classification.mdx
rename to docs/source/ko/tasks/sequence_classification.md
index 32cf216d7b..bc364d3199 100644
--- a/docs/source/ko/tasks/sequence_classification.mdx
+++ b/docs/source/ko/tasks/sequence_classification.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # 텍스트 분류[[text-classification]]
diff --git a/docs/source/ko/tasks/summarization.mdx b/docs/source/ko/tasks/summarization.md
similarity index 99%
rename from docs/source/ko/tasks/summarization.mdx
rename to docs/source/ko/tasks/summarization.md
index 19c6c70732..5ca5f63a27 100644
--- a/docs/source/ko/tasks/summarization.mdx
+++ b/docs/source/ko/tasks/summarization.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # 요약[[summarization]]
diff --git a/docs/source/ko/tasks/token_classification.mdx b/docs/source/ko/tasks/token_classification.md
similarity index 99%
rename from docs/source/ko/tasks/token_classification.mdx
rename to docs/source/ko/tasks/token_classification.md
index c0c0271828..b09c2c8078 100644
--- a/docs/source/ko/tasks/token_classification.mdx
+++ b/docs/source/ko/tasks/token_classification.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # 토큰 분류[[token-classification]]
diff --git a/docs/source/ko/tasks/translation.mdx b/docs/source/ko/tasks/translation.md
similarity index 99%
rename from docs/source/ko/tasks/translation.mdx
rename to docs/source/ko/tasks/translation.md
index f0256052af..b18f56d13b 100644
--- a/docs/source/ko/tasks/translation.mdx
+++ b/docs/source/ko/tasks/translation.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # 번역[[translation]]
diff --git a/docs/source/ko/tasks/video_classification.mdx b/docs/source/ko/tasks/video_classification.md
similarity index 99%
rename from docs/source/ko/tasks/video_classification.mdx
rename to docs/source/ko/tasks/video_classification.md
index 4d185b0aa7..eb04352d84 100644
--- a/docs/source/ko/tasks/video_classification.mdx
+++ b/docs/source/ko/tasks/video_classification.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # 영상 분류 [[video-classification]]
diff --git a/docs/source/ko/tasks/zero_shot_image_classification.mdx b/docs/source/ko/tasks/zero_shot_image_classification.md
similarity index 97%
rename from docs/source/ko/tasks/zero_shot_image_classification.mdx
rename to docs/source/ko/tasks/zero_shot_image_classification.md
index 199c089007..f824de93b8 100644
--- a/docs/source/ko/tasks/zero_shot_image_classification.mdx
+++ b/docs/source/ko/tasks/zero_shot_image_classification.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # 제로샷(zero-shot) 이미지 분류[[zeroshot-image-classification]]
diff --git a/docs/source/ko/tasks/zero_shot_object_detection.mdx b/docs/source/ko/tasks/zero_shot_object_detection.md
similarity index 98%
rename from docs/source/ko/tasks/zero_shot_object_detection.mdx
rename to docs/source/ko/tasks/zero_shot_object_detection.md
index c1dc6c732d..8e9b52e8c7 100644
--- a/docs/source/ko/tasks/zero_shot_object_detection.mdx
+++ b/docs/source/ko/tasks/zero_shot_object_detection.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # 제로샷(zero-shot) 객체 탐지[[zeroshot-object-detection]]
diff --git a/docs/source/ko/tasks_explained.mdx b/docs/source/ko/tasks_explained.md
similarity index 99%
rename from docs/source/ko/tasks_explained.mdx
rename to docs/source/ko/tasks_explained.md
index 7bef350dc8..78c90849bb 100644
--- a/docs/source/ko/tasks_explained.mdx
+++ b/docs/source/ko/tasks_explained.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # 🤗 Transformers로 작업을 해결하는 방법[[how-transformers-solve-tasks]]
diff --git a/docs/source/ko/torchscript.mdx b/docs/source/ko/torchscript.md
similarity index 98%
rename from docs/source/ko/torchscript.mdx
rename to docs/source/ko/torchscript.md
index 1a22baf92b..297479caf2 100644
--- a/docs/source/ko/torchscript.mdx
+++ b/docs/source/ko/torchscript.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # TorchScript로 내보내기[[export-to-torchscript]]
diff --git a/docs/source/ko/training.mdx b/docs/source/ko/training.md
similarity index 99%
rename from docs/source/ko/training.mdx
rename to docs/source/ko/training.md
index 0366c656f0..4e375f0f72 100644
--- a/docs/source/ko/training.mdx
+++ b/docs/source/ko/training.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # 사전 학습된 모델 미세 튜닝하기[[finetune-a-pretrained-model]]
diff --git a/docs/source/ko/troubleshooting.mdx b/docs/source/ko/troubleshooting.md
similarity index 98%
rename from docs/source/ko/troubleshooting.mdx
rename to docs/source/ko/troubleshooting.md
index 56c27df9fc..5eef788e09 100644
--- a/docs/source/ko/troubleshooting.mdx
+++ b/docs/source/ko/troubleshooting.md
@@ -12,6 +12,10 @@ distributed under the License is distributed on an "AS IS" BASIS,
 WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 See the License for the specific language governing permissions and
 limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # 문제 해결[[troubleshoot]]
diff --git a/docs/source/ms/index.mdx b/docs/source/ms/index.md
similarity index 99%
rename from docs/source/ms/index.mdx
rename to docs/source/ms/index.md
index c7dc916d16..8ae0b484aa 100644
--- a/docs/source/ms/index.mdx
+++ b/docs/source/ms/index.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Melainkan diperlukan oleh undang-undang yang terpakai atau dipersetujui secara bertulis, perisian yang diedarkan di bawah Lesen diedarkan pada
 ASAS ""SEBAGAIMANA ADANYA"", TANPA WARANTI ATAU SEBARANG JENIS SYARAT, sama ada nyata atau tersirat. Lihat Lesen untuk
 bahasa tertentu yang mengawal kebenaran dan pengehadan di bawah Lesen.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # 🤗 Transformers
diff --git a/docs/source/pt/accelerate.mdx b/docs/source/pt/accelerate.md
similarity index 96%
rename from docs/source/pt/accelerate.mdx
rename to docs/source/pt/accelerate.md
index 59dbd96a83..a4e346a2b4 100644
--- a/docs/source/pt/accelerate.mdx
+++ b/docs/source/pt/accelerate.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # Treinamento distribuído com o 🤗 Accelerate
diff --git a/docs/source/pt/converting_tensorflow_models.mdx b/docs/source/pt/converting_tensorflow_models.md
similarity index 97%
rename from docs/source/pt/converting_tensorflow_models.mdx
rename to docs/source/pt/converting_tensorflow_models.md
index db7be687c3..ac1271d276 100644
--- a/docs/source/pt/converting_tensorflow_models.mdx
+++ b/docs/source/pt/converting_tensorflow_models.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # Convertendo checkpoints do TensorFlow para Pytorch
diff --git a/docs/source/pt/create_a_model.mdx b/docs/source/pt/create_a_model.md
similarity index 98%
rename from docs/source/pt/create_a_model.mdx
rename to docs/source/pt/create_a_model.md
index bde2b1b187..8c53752d6c 100644
--- a/docs/source/pt/create_a_model.mdx
+++ b/docs/source/pt/create_a_model.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # Criar uma arquitetura customizada
diff --git a/docs/source/pt/custom_models.mdx b/docs/source/pt/custom_models.md
similarity index 98%
rename from docs/source/pt/custom_models.mdx
rename to docs/source/pt/custom_models.md
index 59484dcc35..70c56913a3 100644
--- a/docs/source/pt/custom_models.mdx
+++ b/docs/source/pt/custom_models.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # Compartilhando modelos customizados
diff --git a/docs/source/pt/fast_tokenizers.mdx b/docs/source/pt/fast_tokenizers.md
similarity index 94%
rename from docs/source/pt/fast_tokenizers.mdx
rename to docs/source/pt/fast_tokenizers.md
index aff9afb31f..ea1da8a615 100644
--- a/docs/source/pt/fast_tokenizers.mdx
+++ b/docs/source/pt/fast_tokenizers.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # Usando os Tokenizers do 🤗 Tokenizers
diff --git a/docs/source/pt/index.mdx b/docs/source/pt/index.md
similarity index 99%
rename from docs/source/pt/index.mdx
rename to docs/source/pt/index.md
index e9de6f464d..08575b0bea 100644
--- a/docs/source/pt/index.mdx
+++ b/docs/source/pt/index.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # 🤗 Transformers
diff --git a/docs/source/pt/installation.mdx b/docs/source/pt/installation.md
similarity index 98%
rename from docs/source/pt/installation.mdx
rename to docs/source/pt/installation.md
index 2325cc74af..15b59f7d87 100644
--- a/docs/source/pt/installation.mdx
+++ b/docs/source/pt/installation.md
@@ -12,6 +12,10 @@ distributed under the License is distributed on an "AS IS" BASIS,
 WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 See the License for the specific language governing permissions and
 limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # Guia de Instalação
diff --git a/docs/source/pt/multilingual.mdx b/docs/source/pt/multilingual.md
similarity index 98%
rename from docs/source/pt/multilingual.mdx
rename to docs/source/pt/multilingual.md
index 4db9b54dab..b6366b8c22 100644
--- a/docs/source/pt/multilingual.mdx
+++ b/docs/source/pt/multilingual.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # Modelos multilinguísticos para inferência
diff --git a/docs/source/pt/pipeline_tutorial.mdx b/docs/source/pt/pipeline_tutorial.md
similarity index 96%
rename from docs/source/pt/pipeline_tutorial.mdx
rename to docs/source/pt/pipeline_tutorial.md
index 2991bcecde..a7ea712568 100644
--- a/docs/source/pt/pipeline_tutorial.mdx
+++ b/docs/source/pt/pipeline_tutorial.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # Pipelines para inferência
@@ -105,7 +109,7 @@ Passe seu texto de entrada ao [`pipeline`] para gerar algum texto:
 A flexibilidade do [`pipeline`] significa que também pode-se extender às tarefas de áudio.
 La flexibilidad de [`pipeline`] significa que también se puede extender a tareas de audio.
 
-Por exemplo, classifiquemos a emoção de um breve fragmento do famoso discurso de John F. Kennedy /home/rzimmerdev/dev/transformers/docs/source/pt/pipeline_tutorial.mdx
+Por exemplo, classifiquemos a emoção de um breve fragmento do famoso discurso de John F. Kennedy /home/rzimmerdev/dev/transformers/docs/source/pt/pipeline_tutorial.md
 Encontre um modelo de [audio classification](https://huggingface.co/models?pipeline_tag=audio-classification) para
 reconhecimento de emoções no Model Hub e carregue-o usando o [`pipeline`]:
 
diff --git a/docs/source/pt/quicktour.mdx b/docs/source/pt/quicktour.md
similarity index 99%
rename from docs/source/pt/quicktour.mdx
rename to docs/source/pt/quicktour.md
index 3c00a64b66..e807124de5 100644
--- a/docs/source/pt/quicktour.mdx
+++ b/docs/source/pt/quicktour.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # Tour rápido
diff --git a/docs/source/pt/run_scripts.mdx b/docs/source/pt/run_scripts.md
similarity index 99%
rename from docs/source/pt/run_scripts.mdx
rename to docs/source/pt/run_scripts.md
index e91c4fc87d..8d87c10c27 100644
--- a/docs/source/pt/run_scripts.mdx
+++ b/docs/source/pt/run_scripts.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # Treinamento a partir de um script
diff --git a/docs/source/pt/serialization.mdx b/docs/source/pt/serialization.md
similarity index 99%
rename from docs/source/pt/serialization.mdx
rename to docs/source/pt/serialization.md
index 5e95d59512..d5a21c7f89 100644
--- a/docs/source/pt/serialization.mdx
+++ b/docs/source/pt/serialization.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # Exportando modelos para ONNX 
diff --git a/docs/source/pt/tasks/sequence_classification.mdx b/docs/source/pt/tasks/sequence_classification.md
similarity index 98%
rename from docs/source/pt/tasks/sequence_classification.mdx
rename to docs/source/pt/tasks/sequence_classification.md
index 7c443e700d..cc04f5dbae 100644
--- a/docs/source/pt/tasks/sequence_classification.mdx
+++ b/docs/source/pt/tasks/sequence_classification.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # Classificação de texto
diff --git a/docs/source/pt/tasks/token_classification.mdx b/docs/source/pt/tasks/token_classification.md
similarity index 98%
rename from docs/source/pt/tasks/token_classification.mdx
rename to docs/source/pt/tasks/token_classification.md
index 780080a60d..1de82f4a50 100644
--- a/docs/source/pt/tasks/token_classification.mdx
+++ b/docs/source/pt/tasks/token_classification.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # Classificação de tokens
diff --git a/docs/source/pt/training.mdx b/docs/source/pt/training.md
similarity index 98%
rename from docs/source/pt/training.mdx
rename to docs/source/pt/training.md
index d84f227aec..aa529ac948 100644
--- a/docs/source/pt/training.mdx
+++ b/docs/source/pt/training.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # Fine-tuning de um modelo pré-treinado
diff --git a/docs/source/zh/index.mdx b/docs/source/zh/index.md
similarity index 99%
rename from docs/source/zh/index.mdx
rename to docs/source/zh/index.md
index 71f5d7e3b1..38e758caf7 100644
--- a/docs/source/zh/index.mdx
+++ b/docs/source/zh/index.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # 🤗 Transformers简介
diff --git a/docs/source/zh/quicktour.mdx b/docs/source/zh/quicktour.md
similarity index 99%
rename from docs/source/zh/quicktour.mdx
rename to docs/source/zh/quicktour.md
index a9125136ce..4168817311 100644
--- a/docs/source/zh/quicktour.mdx
+++ b/docs/source/zh/quicktour.md
@@ -8,6 +8,10 @@ http://www.apache.org/licenses/LICENSE-2.0
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
 an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
+rendered properly in your Markdown viewer.
+
 -->
 
 # 快速上手
diff --git a/setup.cfg b/setup.cfg
index 8b84d3a6d9..ffe8973dd2 100644
--- a/setup.cfg
+++ b/setup.cfg
@@ -1,3 +1,3 @@
 [tool:pytest]
 doctest_optionflags=NUMBER NORMALIZE_WHITESPACE ELLIPSIS
-doctest_glob=**/*.mdx
\ No newline at end of file
+doctest_glob=**/*.md
\ No newline at end of file
diff --git a/src/transformers/commands/add_new_model.py b/src/transformers/commands/add_new_model.py
index 85d053a148..87949827d9 100644
--- a/src/transformers/commands/add_new_model.py
+++ b/src/transformers/commands/add_new_model.py
@@ -183,8 +183,8 @@ class AddNewModelCommand(BaseTransformersCLICommand):
             os.remove(f"{directory}/test_modeling_flax_{lowercase_model_name}.py")
 
         shutil.move(
-            f"{directory}/{lowercase_model_name}.mdx",
-            f"{path_to_transformer_root}/docs/source/en/model_doc/{lowercase_model_name}.mdx",
+            f"{directory}/{lowercase_model_name}.md",
+            f"{path_to_transformer_root}/docs/source/en/model_doc/{lowercase_model_name}.md",
         )
 
         shutil.move(
diff --git a/src/transformers/commands/add_new_model_like.py b/src/transformers/commands/add_new_model_like.py
index 91ce8a143c..a232ad34db 100644
--- a/src/transformers/commands/add_new_model_like.py
+++ b/src/transformers/commands/add_new_model_like.py
@@ -646,7 +646,7 @@ def get_model_files(model_type: str, frameworks: Optional[List[str]] = None) ->
     model_files = list(model_module.glob("*.py"))
     model_files = filter_framework_files(model_files, frameworks=frameworks)
 
-    doc_file = REPO_PATH / "docs" / "source" / "en" / "model_doc" / f"{model_type}.mdx"
+    doc_file = REPO_PATH / "docs" / "source" / "en" / "model_doc" / f"{model_type}.md"
 
     # Basic pattern for test files
     test_files = [
@@ -1185,7 +1185,7 @@ def duplicate_doc_file(
         old_model_patterns (`ModelPatterns`): The patterns for the old model.
         new_model_patterns (`ModelPatterns`): The patterns for the new model.
         dest_file (`str` or `os.PathLike`, *optional*): Path to the new doc file.
-            Will default to the a file named `{new_model_patterns.model_type}.mdx` in the same folder as `module_file`.
+            Will default to the a file named `{new_model_patterns.model_type}.md` in the same folder as `module_file`.
         frameworks (`List[str]`, *optional*):
             If passed, will only keep the model classes corresponding to this list of frameworks in the new doc file.
     """
@@ -1196,7 +1196,7 @@ def duplicate_doc_file(
     if frameworks is None:
         frameworks = get_default_frameworks()
     if dest_file is None:
-        dest_file = Path(doc_file).parent / f"{new_model_patterns.model_type}.mdx"
+        dest_file = Path(doc_file).parent / f"{new_model_patterns.model_type}.md"
 
     # Parse the doc file in blocks. One block per section/header
     lines = content.split("\n")
@@ -1405,7 +1405,7 @@ def create_new_model_like(
     add_model_to_auto_classes(old_model_patterns, new_model_patterns, model_classes)
 
     # 5. Add doc file
-    doc_file = REPO_PATH / "docs" / "source" / "en" / "model_doc" / f"{old_model_patterns.model_type}.mdx"
+    doc_file = REPO_PATH / "docs" / "source" / "en" / "model_doc" / f"{old_model_patterns.model_type}.md"
     duplicate_doc_file(doc_file, old_model_patterns, new_model_patterns, frameworks=frameworks)
 
     # 6. Warn the user for duplicate patterns
diff --git a/src/transformers/testing_utils.py b/src/transformers/testing_utils.py
index a3a4baa1f0..e911769a12 100644
--- a/src/transformers/testing_utils.py
+++ b/src/transformers/testing_utils.py
@@ -1857,9 +1857,9 @@ To skip cuda tests, make sure to call `SKIP_CUDA_DOCTEST=1 pytest --doctest-modu
 
 
 def preprocess_string(string, skip_cuda_tests):
-    """Prepare a docstring or a `.mdx` file to be run by doctest.
+    """Prepare a docstring or a `.md` file to be run by doctest.
 
-    The argument `string` would be the whole file content if it is a `.mdx` file. For a python file, it would be one of
+    The argument `string` would be the whole file content if it is a `.md` file. For a python file, it would be one of
     its docstring. In each case, it may contain multiple python code examples. If `skip_cuda_tests` is `True` and a
     cuda stuff is detective (with a heuristic), this method will return an empty string so no doctest will be run for
     `string`.
diff --git a/templates/adding_a_new_model/README.md b/templates/adding_a_new_model/README.md
index 42c423c02e..e1785853dc 100644
--- a/templates/adding_a_new_model/README.md
+++ b/templates/adding_a_new_model/README.md
@@ -92,7 +92,7 @@ Choose from 1, 2 [1]:
 
 Once the command has finished, you should have a total of 7 new files spread across the repository:
 ```
-docs/source/model_doc/<model_name>.mdx
+docs/source/model_doc/<model_name>.md
 src/transformers/models/<model_name>/configuration_<model_name>.py
 src/transformers/models/<model_name>/modeling_<model_name>.py
 src/transformers/models/<model_name>/modeling_tf_<model_name>.py
@@ -242,7 +242,7 @@ make fix-copies
 ```
 
 and then you can start tweaking your model. You should:
-- fill the doc file at `docs/source/model_doc/model_name.mdx`
+- fill the doc file at `docs/source/model_doc/model_name.md`
 - tweak the configuration and modeling files to your need
 
 Once you're done, you can run the tests to ensure that they all pass:
diff --git a/tests/utils/test_add_new_model_like.py b/tests/utils/test_add_new_model_like.py
index 0f334da31c..61ccc184f5 100644
--- a/tests/utils/test_add_new_model_like.py
+++ b/tests/utils/test_add_new_model_like.py
@@ -471,7 +471,7 @@ NEW_BERT_CONSTANT = "value"
         bert_files = get_model_files("bert")
 
         doc_file = str(Path(bert_files["doc_file"]).relative_to(REPO_PATH))
-        self.assertEqual(doc_file, "docs/source/en/model_doc/bert.mdx")
+        self.assertEqual(doc_file, "docs/source/en/model_doc/bert.md")
 
         model_files = {str(Path(f).relative_to(REPO_PATH)) for f in bert_files["model_files"]}
         self.assertEqual(model_files, BERT_MODEL_FILES)
@@ -490,7 +490,7 @@ NEW_BERT_CONSTANT = "value"
         # VIT
         vit_files = get_model_files("vit")
         doc_file = str(Path(vit_files["doc_file"]).relative_to(REPO_PATH))
-        self.assertEqual(doc_file, "docs/source/en/model_doc/vit.mdx")
+        self.assertEqual(doc_file, "docs/source/en/model_doc/vit.md")
 
         model_files = {str(Path(f).relative_to(REPO_PATH)) for f in vit_files["model_files"]}
         self.assertEqual(model_files, VIT_MODEL_FILES)
@@ -509,7 +509,7 @@ NEW_BERT_CONSTANT = "value"
         # Wav2Vec2
         wav2vec2_files = get_model_files("wav2vec2")
         doc_file = str(Path(wav2vec2_files["doc_file"]).relative_to(REPO_PATH))
-        self.assertEqual(doc_file, "docs/source/en/model_doc/wav2vec2.mdx")
+        self.assertEqual(doc_file, "docs/source/en/model_doc/wav2vec2.md")
 
         model_files = {str(Path(f).relative_to(REPO_PATH)) for f in wav2vec2_files["model_files"]}
         self.assertEqual(model_files, WAV2VEC2_MODEL_FILES)
@@ -532,7 +532,7 @@ NEW_BERT_CONSTANT = "value"
         bert_files = get_model_files("bert", frameworks=["pt"])
 
         doc_file = str(Path(bert_files["doc_file"]).relative_to(REPO_PATH))
-        self.assertEqual(doc_file, "docs/source/en/model_doc/bert.mdx")
+        self.assertEqual(doc_file, "docs/source/en/model_doc/bert.md")
 
         model_files = {str(Path(f).relative_to(REPO_PATH)) for f in bert_files["model_files"]}
         bert_model_files = BERT_MODEL_FILES - {
@@ -553,7 +553,7 @@ NEW_BERT_CONSTANT = "value"
         # VIT
         vit_files = get_model_files("vit", frameworks=["pt"])
         doc_file = str(Path(vit_files["doc_file"]).relative_to(REPO_PATH))
-        self.assertEqual(doc_file, "docs/source/en/model_doc/vit.mdx")
+        self.assertEqual(doc_file, "docs/source/en/model_doc/vit.md")
 
         model_files = {str(Path(f).relative_to(REPO_PATH)) for f in vit_files["model_files"]}
         vit_model_files = VIT_MODEL_FILES - {
@@ -574,7 +574,7 @@ NEW_BERT_CONSTANT = "value"
         # Wav2Vec2
         wav2vec2_files = get_model_files("wav2vec2", frameworks=["pt"])
         doc_file = str(Path(wav2vec2_files["doc_file"]).relative_to(REPO_PATH))
-        self.assertEqual(doc_file, "docs/source/en/model_doc/wav2vec2.mdx")
+        self.assertEqual(doc_file, "docs/source/en/model_doc/wav2vec2.md")
 
         model_files = {str(Path(f).relative_to(REPO_PATH)) for f in wav2vec2_files["model_files"]}
         wav2vec2_model_files = WAV2VEC2_MODEL_FILES - {
@@ -599,7 +599,7 @@ NEW_BERT_CONSTANT = "value"
         bert_files = get_model_files("bert", frameworks=["tf", "flax"])
 
         doc_file = str(Path(bert_files["doc_file"]).relative_to(REPO_PATH))
-        self.assertEqual(doc_file, "docs/source/en/model_doc/bert.mdx")
+        self.assertEqual(doc_file, "docs/source/en/model_doc/bert.md")
 
         model_files = {str(Path(f).relative_to(REPO_PATH)) for f in bert_files["model_files"]}
         bert_model_files = BERT_MODEL_FILES - {"src/transformers/models/bert/modeling_bert.py"}
@@ -618,7 +618,7 @@ NEW_BERT_CONSTANT = "value"
         # VIT
         vit_files = get_model_files("vit", frameworks=["tf", "flax"])
         doc_file = str(Path(vit_files["doc_file"]).relative_to(REPO_PATH))
-        self.assertEqual(doc_file, "docs/source/en/model_doc/vit.mdx")
+        self.assertEqual(doc_file, "docs/source/en/model_doc/vit.md")
 
         model_files = {str(Path(f).relative_to(REPO_PATH)) for f in vit_files["model_files"]}
         vit_model_files = VIT_MODEL_FILES - {"src/transformers/models/vit/modeling_vit.py"}
@@ -637,7 +637,7 @@ NEW_BERT_CONSTANT = "value"
         # Wav2Vec2
         wav2vec2_files = get_model_files("wav2vec2", frameworks=["tf", "flax"])
         doc_file = str(Path(wav2vec2_files["doc_file"]).relative_to(REPO_PATH))
-        self.assertEqual(doc_file, "docs/source/en/model_doc/wav2vec2.mdx")
+        self.assertEqual(doc_file, "docs/source/en/model_doc/wav2vec2.md")
 
         model_files = {str(Path(f).relative_to(REPO_PATH)) for f in wav2vec2_files["model_files"]}
         wav2vec2_model_files = WAV2VEC2_MODEL_FILES - {"src/transformers/models/wav2vec2/modeling_wav2vec2.py"}
@@ -713,7 +713,7 @@ NEW_BERT_CONSTANT = "value"
         self.assertEqual(test_files, bert_test_files)
 
         doc_file = str(Path(all_bert_files["doc_file"]).relative_to(REPO_PATH))
-        self.assertEqual(doc_file, "docs/source/en/model_doc/bert.mdx")
+        self.assertEqual(doc_file, "docs/source/en/model_doc/bert.md")
 
         self.assertEqual(all_bert_files["module_name"], "bert")
 
@@ -762,7 +762,7 @@ NEW_BERT_CONSTANT = "value"
         self.assertEqual(test_files, bert_test_files)
 
         doc_file = str(Path(all_bert_files["doc_file"]).relative_to(REPO_PATH))
-        self.assertEqual(doc_file, "docs/source/en/model_doc/bert.mdx")
+        self.assertEqual(doc_file, "docs/source/en/model_doc/bert.md")
 
         self.assertEqual(all_bert_files["module_name"], "bert")
 
@@ -806,7 +806,7 @@ NEW_BERT_CONSTANT = "value"
         self.assertEqual(test_files, vit_test_files)
 
         doc_file = str(Path(all_vit_files["doc_file"]).relative_to(REPO_PATH))
-        self.assertEqual(doc_file, "docs/source/en/model_doc/vit.mdx")
+        self.assertEqual(doc_file, "docs/source/en/model_doc/vit.md")
 
         self.assertEqual(all_vit_files["module_name"], "vit")
 
@@ -860,7 +860,7 @@ NEW_BERT_CONSTANT = "value"
         self.assertEqual(test_files, wav2vec2_test_files)
 
         doc_file = str(Path(all_wav2vec2_files["doc_file"]).relative_to(REPO_PATH))
-        self.assertEqual(doc_file, "docs/source/en/model_doc/wav2vec2.mdx")
+        self.assertEqual(doc_file, "docs/source/en/model_doc/wav2vec2.md")
 
         self.assertEqual(all_wav2vec2_files["module_name"], "wav2vec2")
 
@@ -1476,8 +1476,8 @@ The original code can be found [here](<INSERT LINK TO GITHUB REPO HERE>).
 """
 
         with tempfile.TemporaryDirectory() as tmp_dir:
-            doc_file = os.path.join(tmp_dir, "gpt2.mdx")
-            new_doc_file = os.path.join(tmp_dir, "gpt-new-new.mdx")
+            doc_file = os.path.join(tmp_dir, "gpt2.md")
+            new_doc_file = os.path.join(tmp_dir, "gpt-new-new.md")
 
             gpt2_model_patterns = ModelPatterns("GPT2", "gpt2", tokenizer_class="GPT2Tokenizer")
             new_model_patterns = ModelPatterns(
diff --git a/utils/check_copies.py b/utils/check_copies.py
index bd79aa9e86..0dbc7b889e 100644
--- a/utils/check_copies.py
+++ b/utils/check_copies.py
@@ -440,7 +440,7 @@ def check_model_list_copy(overwrite=False, max_per_line=119):
 
     # If the introduction or the conclusion of the list change, the prompts may need to be updated.
     index_list, start_index, end_index, lines = _find_text_in_file(
-        filename=os.path.join(PATH_TO_DOCS, "index.mdx"),
+        filename=os.path.join(PATH_TO_DOCS, "index.md"),
         start_prompt="<!--This list is updated automatically from the README",
         end_prompt="### Supported frameworks",
     )
@@ -464,11 +464,11 @@ def check_model_list_copy(overwrite=False, max_per_line=119):
     converted_md_list = convert_readme_to_index(md_list)
     if converted_md_list != index_list:
         if overwrite:
-            with open(os.path.join(PATH_TO_DOCS, "index.mdx"), "w", encoding="utf-8", newline="\n") as f:
+            with open(os.path.join(PATH_TO_DOCS, "index.md"), "w", encoding="utf-8", newline="\n") as f:
                 f.writelines(lines[:start_index] + [converted_md_list] + lines[end_index:])
         else:
             raise ValueError(
-                "The model list in the README changed and the list in `index.mdx` has not been updated. Run "
+                "The model list in the README changed and the list in `index.md` has not been updated. Run "
                 "`make fix-copies` to fix this."
             )
 
diff --git a/utils/check_repo.py b/utils/check_repo.py
index 12615550a8..81dbfcb5f0 100644
--- a/utils/check_repo.py
+++ b/utils/check_repo.py
@@ -756,7 +756,7 @@ def find_all_documented_objects():
             content = f.read()
         raw_doc_objs = re.findall(r"(?:autoclass|autofunction):: transformers.(\S+)\s+", content)
         documented_obj += [obj.split(".")[-1] for obj in raw_doc_objs]
-    for doc_file in Path(PATH_TO_DOC).glob("**/*.mdx"):
+    for doc_file in Path(PATH_TO_DOC).glob("**/*.md"):
         with open(doc_file, "r", encoding="utf-8", newline="\n") as f:
             content = f.read()
         raw_doc_objs = re.findall(r"\[\[autodoc\]\]\s+(\S+)\s+", content)
@@ -908,7 +908,7 @@ def check_all_objects_are_documented():
 def check_model_type_doc_match():
     """Check all doc pages have a corresponding model type."""
     model_doc_folder = Path(PATH_TO_DOC) / "model_doc"
-    model_docs = [m.stem for m in model_doc_folder.glob("*.mdx")]
+    model_docs = [m.stem for m in model_doc_folder.glob("*.md")]
 
     model_types = list(transformers.models.auto.configuration_auto.MODEL_NAMES_MAPPING.keys())
     model_types = [MODEL_TYPE_TO_DOC_MAPPING[m] if m in MODEL_TYPE_TO_DOC_MAPPING else m for m in model_types]
diff --git a/utils/check_table.py b/utils/check_table.py
index 80593881a3..77eabe4093 100644
--- a/utils/check_table.py
+++ b/utils/check_table.py
@@ -157,7 +157,7 @@ def get_model_table_from_auto_modules():
 def check_model_table(overwrite=False):
     """Check the model table in the index.rst is consistent with the state of the lib and maybe `overwrite`."""
     current_table, start_index, end_index, lines = _find_text_in_file(
-        filename=os.path.join(PATH_TO_DOCS, "index.mdx"),
+        filename=os.path.join(PATH_TO_DOCS, "index.md"),
         start_prompt="<!--This table is updated automatically from the auto modules",
         end_prompt="<!-- End table-->",
     )
@@ -165,11 +165,11 @@ def check_model_table(overwrite=False):
 
     if current_table != new_table:
         if overwrite:
-            with open(os.path.join(PATH_TO_DOCS, "index.mdx"), "w", encoding="utf-8", newline="\n") as f:
+            with open(os.path.join(PATH_TO_DOCS, "index.md"), "w", encoding="utf-8", newline="\n") as f:
                 f.writelines(lines[:start_index] + [new_table] + lines[end_index:])
         else:
             raise ValueError(
-                "The model table in the `index.mdx` has not been updated. Run `make fix-copies` to fix this."
+                "The model table in the `index.md` has not been updated. Run `make fix-copies` to fix this."
             )
 
 
diff --git a/utils/check_task_guides.py b/utils/check_task_guides.py
index 42515439a9..a4dde52116 100644
--- a/utils/check_task_guides.py
+++ b/utils/check_task_guides.py
@@ -55,29 +55,29 @@ def _find_text_in_file(filename, start_prompt, end_prompt):
 transformers_module = direct_transformers_import(TRANSFORMERS_PATH)
 
 TASK_GUIDE_TO_MODELS = {
-    "asr.mdx": transformers_module.models.auto.modeling_auto.MODEL_FOR_CTC_MAPPING_NAMES,
-    "audio_classification.mdx": transformers_module.models.auto.modeling_auto.MODEL_FOR_AUDIO_CLASSIFICATION_MAPPING_NAMES,
-    "language_modeling.mdx": transformers_module.models.auto.modeling_auto.MODEL_FOR_CAUSAL_LM_MAPPING_NAMES,
-    "image_classification.mdx": transformers_module.models.auto.modeling_auto.MODEL_FOR_IMAGE_CLASSIFICATION_MAPPING_NAMES,
-    "masked_language_modeling.mdx": transformers_module.models.auto.modeling_auto.MODEL_FOR_MASKED_LM_MAPPING_NAMES,
-    "multiple_choice.mdx": transformers_module.models.auto.modeling_auto.MODEL_FOR_MULTIPLE_CHOICE_MAPPING_NAMES,
-    "object_detection.mdx": transformers_module.models.auto.modeling_auto.MODEL_FOR_OBJECT_DETECTION_MAPPING_NAMES,
-    "question_answering.mdx": transformers_module.models.auto.modeling_auto.MODEL_FOR_QUESTION_ANSWERING_MAPPING_NAMES,
-    "semantic_segmentation.mdx": transformers_module.models.auto.modeling_auto.MODEL_FOR_SEMANTIC_SEGMENTATION_MAPPING_NAMES,
-    "sequence_classification.mdx": transformers_module.models.auto.modeling_auto.MODEL_FOR_SEQUENCE_CLASSIFICATION_MAPPING_NAMES,
-    "summarization.mdx": transformers_module.models.auto.modeling_auto.MODEL_FOR_SEQ_TO_SEQ_CAUSAL_LM_MAPPING_NAMES,
-    "token_classification.mdx": transformers_module.models.auto.modeling_auto.MODEL_FOR_TOKEN_CLASSIFICATION_MAPPING_NAMES,
-    "translation.mdx": transformers_module.models.auto.modeling_auto.MODEL_FOR_SEQ_TO_SEQ_CAUSAL_LM_MAPPING_NAMES,
-    "video_classification.mdx": transformers_module.models.auto.modeling_auto.MODEL_FOR_VIDEO_CLASSIFICATION_MAPPING_NAMES,
-    "document_question_answering.mdx": transformers_module.models.auto.modeling_auto.MODEL_FOR_DOCUMENT_QUESTION_ANSWERING_MAPPING_NAMES,
-    "monocular_depth_estimation.mdx": transformers_module.models.auto.modeling_auto.MODEL_FOR_DEPTH_ESTIMATION_MAPPING_NAMES,
+    "asr.md": transformers_module.models.auto.modeling_auto.MODEL_FOR_CTC_MAPPING_NAMES,
+    "audio_classification.md": transformers_module.models.auto.modeling_auto.MODEL_FOR_AUDIO_CLASSIFICATION_MAPPING_NAMES,
+    "language_modeling.md": transformers_module.models.auto.modeling_auto.MODEL_FOR_CAUSAL_LM_MAPPING_NAMES,
+    "image_classification.md": transformers_module.models.auto.modeling_auto.MODEL_FOR_IMAGE_CLASSIFICATION_MAPPING_NAMES,
+    "masked_language_modeling.md": transformers_module.models.auto.modeling_auto.MODEL_FOR_MASKED_LM_MAPPING_NAMES,
+    "multiple_choice.md": transformers_module.models.auto.modeling_auto.MODEL_FOR_MULTIPLE_CHOICE_MAPPING_NAMES,
+    "object_detection.md": transformers_module.models.auto.modeling_auto.MODEL_FOR_OBJECT_DETECTION_MAPPING_NAMES,
+    "question_answering.md": transformers_module.models.auto.modeling_auto.MODEL_FOR_QUESTION_ANSWERING_MAPPING_NAMES,
+    "semantic_segmentation.md": transformers_module.models.auto.modeling_auto.MODEL_FOR_SEMANTIC_SEGMENTATION_MAPPING_NAMES,
+    "sequence_classification.md": transformers_module.models.auto.modeling_auto.MODEL_FOR_SEQUENCE_CLASSIFICATION_MAPPING_NAMES,
+    "summarization.md": transformers_module.models.auto.modeling_auto.MODEL_FOR_SEQ_TO_SEQ_CAUSAL_LM_MAPPING_NAMES,
+    "token_classification.md": transformers_module.models.auto.modeling_auto.MODEL_FOR_TOKEN_CLASSIFICATION_MAPPING_NAMES,
+    "translation.md": transformers_module.models.auto.modeling_auto.MODEL_FOR_SEQ_TO_SEQ_CAUSAL_LM_MAPPING_NAMES,
+    "video_classification.md": transformers_module.models.auto.modeling_auto.MODEL_FOR_VIDEO_CLASSIFICATION_MAPPING_NAMES,
+    "document_question_answering.md": transformers_module.models.auto.modeling_auto.MODEL_FOR_DOCUMENT_QUESTION_ANSWERING_MAPPING_NAMES,
+    "monocular_depth_estimation.md": transformers_module.models.auto.modeling_auto.MODEL_FOR_DEPTH_ESTIMATION_MAPPING_NAMES,
 }
 
 # This list contains model types used in some task guides that are not in `CONFIG_MAPPING_NAMES` (therefore not in any
 # `MODEL_MAPPING_NAMES` or any `MODEL_FOR_XXX_MAPPING_NAMES`).
 SPECIAL_TASK_GUIDE_TO_MODEL_TYPES = {
-    "summarization.mdx": ("nllb",),
-    "translation.mdx": ("nllb",),
+    "summarization.md": ("nllb",),
+    "translation.md": ("nllb",),
 }
 
 
diff --git a/utils/documentation_tests.txt b/utils/documentation_tests.txt
index 5b95f24a11..0064a9999b 100644
--- a/utils/documentation_tests.txt
+++ b/utils/documentation_tests.txt
@@ -1,17 +1,17 @@
-docs/source/en/quicktour.mdx
-docs/source/es/quicktour.mdx
-docs/source/en/pipeline_tutorial.mdx
-docs/source/en/autoclass_tutorial.mdx
-docs/source/en/task_summary.mdx
-docs/source/en/model_doc/markuplm.mdx
-docs/source/en/model_doc/speech_to_text.mdx
-docs/source/en/model_doc/switch_transformers.mdx
-docs/source/en/model_doc/t5.mdx
-docs/source/en/model_doc/t5v1.1.mdx
-docs/source/en/model_doc/byt5.mdx
-docs/source/en/model_doc/tapex.mdx
-docs/source/en/model_doc/donut.mdx
-docs/source/en/model_doc/encoder-decoder.mdx
+docs/source/en/quicktour.md
+docs/source/es/quicktour.md
+docs/source/en/pipeline_tutorial.md
+docs/source/en/autoclass_tutorial.md
+docs/source/en/task_summary.md
+docs/source/en/model_doc/markuplm.md
+docs/source/en/model_doc/speech_to_text.md
+docs/source/en/model_doc/switch_transformers.md
+docs/source/en/model_doc/t5.md
+docs/source/en/model_doc/t5v1.1.md
+docs/source/en/model_doc/byt5.md
+docs/source/en/model_doc/tapex.md
+docs/source/en/model_doc/donut.md
+docs/source/en/model_doc/encoder-decoder.md
 src/transformers/generation/configuration_utils.py
 src/transformers/generation/tf_utils.py
 src/transformers/generation/utils.py
diff --git a/utils/notification_service_doc_tests.py b/utils/notification_service_doc_tests.py
index 521eb98264..aac768fb39 100644
--- a/utils/notification_service_doc_tests.py
+++ b/utils/notification_service_doc_tests.py
@@ -329,7 +329,7 @@ if __name__ == "__main__":
     docs = collections.OrderedDict(
         [
             ("*.py", "API Examples"),
-            ("*.mdx", "MDX Examples"),
+            ("*.md", "MD Examples"),
         ]
     )
 
diff --git a/utils/tests_fetcher.py b/utils/tests_fetcher.py
index a06a2f672f..b6a1ec87ed 100644
--- a/utils/tests_fetcher.py
+++ b/utils/tests_fetcher.py
@@ -263,14 +263,14 @@ def get_diff_for_doctesting(repo, base_commit, commits):
     code_diff = []
     for commit in commits:
         for diff_obj in commit.diff(base_commit):
-            # We always add new python/mdx files
-            if diff_obj.change_type in ["A"] and (diff_obj.b_path.endswith(".py") or diff_obj.b_path.endswith(".mdx")):
+            # We always add new python/md files
+            if diff_obj.change_type in ["A"] and (diff_obj.b_path.endswith(".py") or diff_obj.b_path.endswith(".md")):
                 code_diff.append(diff_obj.b_path)
             # Now for modified files
             elif (
                 diff_obj.change_type in ["M", "R"]
                 and diff_obj.b_path.endswith(".py")
-                or diff_obj.b_path.endswith(".mdx")
+                or diff_obj.b_path.endswith(".md")
             ):
                 # In case of renames, we'll look at the tests using both the old and new name.
                 if diff_obj.a_path != diff_obj.b_path: