---
title: "یک سند را به Markdown تبدیل کنید"
---

Markdown یک فرمت محبوب است که برای نشانه گذاری متن و تبدیل بیشتر آن به HTML، PDF، DOCX یا فرمت های دیگر استفاده می شود. بسیاری از توسعه دهندگان این قالب را برای نوشتن مستندات، تهیه مقالات برای انتشار در وبلاگ ها، توصیف پروژه ها و غیره انتخاب می کنند.

Markdown بسیار محبوب است زیرا کار با این فرمت آسان است و همچنین می توان آن را به سادگی به فرمت های دیگر تبدیل کرد. به همین دلیل، Aspose.Words توانایی تبدیل یک سند در [هر فرمت بار پشتیبانی شده](https://reference.aspose.com/words/python-net/aspose.words/loadformat/) به Markdown و بالعکس را فراهم می کند - Aspose.Words همچنین از محبوب ترین [ذخیره فرمت ها](https://reference.aspose.com/words/python-net/aspose.words/saveformat/) پشتیبانی می کند.

اکنون عملکرد کار با فرمت Markdown به طور فعال در حال توسعه است تا فرصت های بیشتری را برای کار راحت و راحت با اسناد در اختیار شما قرار دهد.

## تبدیل یک سند

برای تبدیل یک سند به Markdown، فقط باید یک سند را با هر فرمت پشتیبانی شده بارگیری کنید یا یک سند جدید را به صورت برنامه ریزی شده ایجاد کنید. سپس باید سند را با فرمت Markdown ذخیره کنید.

مثال کد زیر نحوه تبدیل DOCX به Markdown را نشان می دهد:

{{< gist "aspose-words-gists" "e9d8f984dac599756ccb4a64b8c79768" "Examples-DocsExamples-DocsExamples-File Formats and Conversions-base_conversions-SaveToMarkdownDocument.py" >}}

همچنین می‌توانید پوشه فیزیکی را که می‌خواهید تصاویر را در هنگام صادرات سند به فرمت Markdown ذخیره کنید، مشخص کنید. به‌طور پیش‌فرض، Aspose.Words تصاویر را در همان پوشه‌ای ذخیره می‌کند که فایل سند در آن ذخیره می‌شود، اما می‌توانید با استفاده از ویژگی [images_folder](https://reference.aspose.com/words/python-net/aspose.words.saving/markdownsaveoptions/images_folder/) این رفتار را لغو کنید.

تعیین یک پوشه از طریق [images_folder](https://reference.aspose.com/words/python-net/aspose.words.saving/markdownsaveoptions/images_folder/) نیز مفید است اگر سندی را در یک جریان ذخیره کنید و Aspose.Words پوشه ای برای ذخیره تصاویر نداشته باشد.

اگر [images_folder](https://reference.aspose.com/words/python-net/aspose.words.saving/markdownsaveoptions/images_folder/) مشخص شده وجود نداشته باشد، به طور خودکار ایجاد می شود.

مثال کد زیر نحوه تعیین یک پوشه برای تصاویر هنگام ذخیره یک سند در یک جریان را نشان می دهد:

{{< gist "aspose-words-gists" "e9d8f984dac599756ccb4a64b8c79768" "Examples-DocsExamples-DocsExamples-File Formats and Conversions-Save Options-working_with_markdown_save_options-SetImagesFolder.py" >}}

## هنگام تبدیل به Markdown گزینه های ذخیره را مشخص کنید

Aspose.Words امکان استفاده از کلاس [MarkdownSaveOptions](https://reference.aspose.com/words/python-net/aspose.words.saving/markdownsaveoptions/) را برای کار با گزینه های پیشرفته هنگام ذخیره یک سند در قالب Markdown فراهم می کند. اکثر ویژگی ها دارای ویژگی های ارث بری یا بارگذاری بیش از حد هستند که قبلاً در سایر کلاس های [aspose.words.saving](https://reference.aspose.com/words/python-net/aspose.words.saving/) وجود دارد. علاوه بر آنها، تعدادی ویژگی که مخصوص فرمت Markdown هستند نیز اضافه شده است. به عنوان مثال، ویژگی [table_content_alignment](https://reference.aspose.com/words/python-net/aspose.words.saving/markdownsaveoptions/table_content_alignment/) برای کنترل تراز محتوا در جداول، یا [images_folder](https://reference.aspose.com/words/python-net/aspose.words.saving/markdownsaveoptions/images_folder/) برای کنترل مکان ذخیره تصاویر پس از تبدیل یک سند به فرمت Markdown.

## پشتیبانی از ویژگی های Markdown

Aspose.Words در حال حاضر از ویژگی‌های Markdown زیر پشتیبانی می‌کند که عمدتاً از مشخصات `CommonMark` در Aspose.Words API پیروی می‌کنند و به عنوان سبک‌های مناسب یا قالب‌بندی مستقیم نشان داده می‌شوند:

* سرفصل ها پاراگراف هایی با سبک سرفصل 1 - سرفصل 6 هستند
* نقل قول ها پاراگراف هایی با "نقل قول" در نام سبک هستند
* IndentedCode پاراگراف هایی با "IndentedCode" در نام سبک هستند
* FencedCode پاراگراف هایی با "FencedCode" در نام سبک هستند
* InlineCode با "InlineCode" در نام سبک `Font` اجرا می شود
* قوانین افقی پاراگراف هایی با شکل `HorizontalRule` هستند
* تاکید جسورانه
* تاکید کج
* قالب بندی StrikeThrough
* فهرست ها پاراگراف های شماره دار یا گلوله ای هستند
* جداول با کلاس [Table](https://reference.aspose.com/words/python-net/aspose.words.tables/table/) نمایش داده می شوند
* پیوندها به عنوان کلاس [FieldHyperlink](https://reference.aspose.com/words/python-net/aspose.words.fields/fieldhyperlink/) نشان داده می شوند

مثال زیر نحوه ایجاد یک سند با چند سبک و ذخیره آن در Markdown را نشان می دهد:

{{< gist "aspose-words-gists" "e9d8f984dac599756ccb4a64b8c79768" "Examples-DocsExamples-DocsExamples-Programming with Documents-working_with_markdown-CreateMarkdownDocument.py" >}}

نتیجه این مثال کد در زیر نشان داده شده است.

![markdown-example-aspose-words-net](/words/python-net/convert-a-document-to-markdown/markdown-example.png)

## نکات مفید

چندین تفاوت ظریف و موارد جالب وجود دارد که با آموختن آنها می توانید انعطاف پذیرتر و راحت تر با فایل های Markdown کار کنید. به عنوان مثال، قابلیت استفاده از:

* SetextHeading که به شما امکان می دهد عناوین چند خطی در Markdown ایجاد کنید، در حالی که عنوان های معمولی در Markdown فقط می توانند تک خطی باشند. SetextHeading بر اساس یک سبک "Heading N" است و سطح آن فقط می تواند 1 یا 2 باشد. اگر N در "Heading N" بزرگتر یا مساوی 2 باشد، SetextHeading مربوطه بر اساس "Heading 2" است، در غیر این صورت در "سرفصل 1".
* نشانگرهای مختلف برای سطح اول لیست های گلوله ای ("-"، "+" یا "*"، نشانگر پیش فرض "-".) و انواع مختلف شماره گذاری برای لیست های مرتب شده ("." یا ")"، نشانگر پیش فرض ".") است.