تبدیل DOCX به Markdown
انتقال مستندات از ورد به یک مخزن Git با تبدیل هر فایل .docx به Markdown آغاز میشود. این مبدل متنی به سبک CommonMark با سرتیترهای #، جدولهای خط‌عمودی و پیوند عکس‌ها می‌نویسد که آمادهٔ commit است.
مبدل سند
یا فایل‌های PDF, DOC, DOCX … را اینجا رها کنید ·
حداکثر 95 MB برای هر فایل· تا 20 فایل· حذف پس از 30 دقیقه
فایل‌ها روی سرورهای ما پردازش میشوند و پس از 30 دقیقه حذف میشوند.
150 DPI یک صفحه A4 را تقریباً به 1240 × 1754 px تبدیل میکند. برای چاپ از 300 استفاده کنید.
کل فایل یا فقط برخی صفحه‌ها یا اسلایدها را تبدیل کنید (برای ورودی PDF و ارائه).
صفحه‌ها یا اسلایدهای موردنظر برای تبدیل، مثلاً 1-3, 5, 8-10.
UTF-8 برای همه زبان‌ها کار میکند. اگر Excel یا Notepad در ویندوز نویسه‌ها را خراب نشان میدهد، UTF-8 با BOM را انتخاب کنید؛ کدگذاری‌های قدیمی فقط برای نرم‌افزارهای قدیمی است.
LF برای macOS، Linux و ویرایشگرهای کد؛ CRLF برای برنامه‌های قدیمی‌تر ویندوز مانند Notepad کلاسیک.
ویرگول حالت استاندارد است. برای Excel در کشورهایی که اعشار را با ویرگول مینویسند (آلمان، فرانسه، برزیل) از نقطهویرگول استفاده کنید.
ورودی Excel با چند برگه: همه را تبدیل کنید (برای هر برگه یک بخش یا فایل) یا فقط برگه اول را.
نحوه استفاده از این ابزار
- 1
فایل‌های ورد را بارگذاری کنید
تا ۲۰ فایل .docx یا .doc را اضافه کنید، هر کدام حداکثر 95 MB. ابتدا تغییرات ردیابی‌شده را در Word بپذیرید یا رد کنید، چون Markdown راهی برای نمایش آن‌ها ندارد.
- 2
گزینه‌های متن را بررسی کنید
گزینهٔ قالب‌بندی روی ساده، رمزگذاری متن روی UTF-8 و پایان خطوط روی LF است؛ ترکیبی که Git و سازنده‌های سایت ایستا انتظار دارند. گزینهٔ شامل تصاویر را روشن نگه دارید تا تصاویر در یک پوشه ذخیره شوند.
- 3
تبدیل کنید و فایل را از حالت فشرده خارج کنید
روی تبدیل به MD بزنید. هر سند بهصورت یک ZIP شامل فایل .md و تصاویرش دریافت میشود؛ آن را در پوشهٔ مستندات خود باز کنید و commit کنید.
چطور سند Word را به Markdown تبدیل کنم؟
فایل .docx را بارگذاری کنید و روی تبدیل به MD بزنید. فایل .md با سرتیترهای #، فهرستها، پیوندها و جدولها دریافت می‌کنید، به‌همراه تصاویر در پوشه‌ای کنار آن، همه در یک ZIP.
تبدیل DOCX به Markdown برای docs-as-code
تیم‌ها به یک دلیل docs-as-code را انتخاب میکنند: مستندات کنار کد میماند، از همان pull requestها می‌گذرد و با همان نسخه منتشر میشود. فایل .docx این روند را می‌شکند، چون ZIPی از بخش‌های XML است که Git آن را بهصورت باینری مبهم نگه می‌دارد. تغییر یک کلمه فقط بهصورت فایل تغییریافته و بدون تفاوت خوانا دیده میشود و دو نفر که هم‌زمان ویرایش کنند نمی‌توانند کارشان را ادغام کنند.
Markdown متن ساده است، پس هر ویرایش یک تغییر خطی قابل‌مشاهده است. در سال 2014 هم بسیار قابل‌پیش‌بینی‌تر شد، وقتی John MacFarlane و دیگران CommonMark را منتشر کردند؛ مشخصاتی دقیق از نحوی که Gruber ده سال قبل به‌طور کلی توصیف کرده بود. GitHub در سال 2017 مشخصات GitHub Flavored Markdown را بر پایهٔ CommonMark ساخت و جدولهای pipe، فهرست وظایف و خط‌خوردگی را اضافه کرد که امروز در بیشتر READMEها استفاده میشود.
اگر محتوای شما مسیر برعکس را می‌رود، یعنی Markdown برای بازبینی‌کننده‌ای که با Word کار میکند، از تبدیل Markdown به DOCX استفاده کنید. برای صفحهٔ وب به‌جای مخزن کد، تبدیل DOCX به HTML سبک‌بندی بیشتری را حفظ میکند.
خروجی Markdown چه شکلی دارد
## چک‌لیست انتشار پیش از برچسب‌گذاری نسخهٔ جدید، موارد زیر را تأیید کنید: - تست‌ها روی **main** با موفقیت اجرا میشوند - تغییرنامه همهٔ PRهای ادغامشده را فهرست میکند | مرحله | مسئول | | --- | --- | | ساخت | CI | | انتشار | نگه‌دارنده | 
Markdown تبدیل‌شده کجا نمایش داده میشود
| سازمان | الزام | منبع |
|---|---|---|
| GitHub | README.md و هر فایل .md در مخزن را با GitHub Flavored Markdown نمایش میدهد | github.com |
| Hugo | صفحات را از فایل‌های محتوای .md با تجزیه‌گر سازگار با CommonMark می‌سازد | gohugo.io |
| Jekyll | فایل‌های .md دارای front matter را به صفحه تبدیل میکند؛ موتور پشت GitHub Pages | jekyllrb.com |
| Docusaurus | فایل‌های .md و .mdx پوشهٔ docs را به‌عنوان صفحات مستندات می‌خواند | docusaurus.io |
DOCX
سند Microsoft Word
DOCX قالب پیش‌فرض سند Microsoft Word از Office 2007 است و بر استاندارد Office Open XML (ECMA-376، ISO/IEC 29500) استوار است. بسته‌ای ZIP از فایل‌های XML است که متن، سبک‌ها، تصاویر، جدولها، نظرها و تغییرات ردیابی‌شده را نگه می‌دارد. رایج‌ترین قالب برای اسناد قابل ویرایش در ادارات، مدارس و درخواست‌های شغلی است. صفحه‌آرایی ممکن است بین Word، Google Docs، LibreOffice و Pages کمی جابه‌جا شود، به‌ویژه با قالب‌بندی پیچیده. بیشتر واژه‌پردازها فایل‌های DOCX را باز میکنند.
- فشرده‌سازی
- –
- شفافیت
- –
- انیمیشن
- –
- سال معرفی
- 2007 · Microsoft
MD
Markdown
Markdown یک نحو نشانه‌گذاری سبک است که John Gruber در سال 2004 ساخت. از نمادهای متن ساده مانند # برای عنوان، * برای تأکید و - برای فهرست استفاده میکند که به صورت متن خام هم خوانا می‌مانند و به‌خوبی به HTML تبدیل میشوند. این قالب استاندارد فایل‌های README، مستندات، ویکی‌ها، برنامه‌های یادداشت و بسیاری از مولدهای سایت ایستا است. گویش‌های مختلفی مانند CommonMark و GitHub Flavored Markdown وجود دارد که در جزئیاتی مثل جدولها فرق دارند. هر ویرایشگر متنی می‌تواند فایل‌های .md را باز کند.
- فشرده‌سازی
- –
- شفافیت
- –
- انیمیشن
- –
- سال معرفی
- 2004 · John Gruber
وقتی سندی وارد جریان کار برنامه‌نویسی میشود، DOCX به Markdown تبدیل میشود: README، سایت مستندات یا پایگاه دانشی که در Git نگهداری میشود و متن ساده‌اش را می‌توان مقایسه کرد، در pull requestها بازبینی کرد و با ابزارهای زیادی نمایش داد.
قابلیت‌هایی از ورد که معادلی در Markdown ندارند
پیش از تبدیل برای این موارد برنامه‌ریزی کنید
- قلم‌ها، رنگ‌ها و چیدمان صفحه حذف میشوند؛ Markdown ساختار را توصیف میکند و پوستهٔ سایت ظاهر را تعیین میکند
- تغییرات ردیابی‌شده و نظرها منتقل نمی‌شوند، پس ابتدا در Word آن‌ها را نهایی کنید
- سرصفحه، پاصفحه و شمارهٔ صفحه در فایل .md جایی ندارند
- کادرهای متن و تصاویر دورچین به پاراگراف‌های معمولی و پیوند تصویر تبدیل میشوند
- سرتیترهایی که دستی قالب‌بندی کرده‌اید، مثلاً بولد 16 pt به‌جای Heading 2، بهصورت متن بولد درمی‌آیند؛ پس ابتدا سبک‌های واقعی سرتیتر را اعمال کنید
- زیرخط نحو Markdown ندارد و حذف میشود یا بهصورت HTML میماند
پرسش‌های رایج دربارهٔ تبدیل DOCX به Markdown
خروجی تبدیل DOCX به MD از کدام نسخهٔ Markdown پیروی میکند؟
سرتیترها، تأکید، فهرستها، پیوندها و کد از CommonMark پیروی میکنند و جدولها از نحو pipe در GitHub Flavored Markdown استفاده میکنند. GitHub، GitLab، Hugo، Jekyll و Docusaurus همگی این ترکیب را نمایش میدهند.
سلولهای ادغامشدهٔ جدول چه میشوند؟
جدولهای pipe در Markdown سلول ادغامشده ندارند، بنابراین هر ناحیهٔ ادغامشده دوباره به سلولهای جدا تقسیم میشود و متن در اولین سلول میماند. جدولهای پیچیده را داخل .md بهصورت HTML بازسازی کنید یا پیش از تبدیل در Word سادهشان کنید.
عکسهای سند ورد من کجا ذخیره میشوند؟
وقتی شامل تصاویر روشن باشد، هر تصویر در ZIP بهصورت فایلی جدا ذخیره میشود و Markdown با مسیر نسبی مانند images/figure-1.png به آن پیوند میدهد. هنگام جابهجایی، پوشه را کنار فایل .md نگه دارید.
آیا پانویس‌های ورد در Markdown حفظ میشوند؟
CommonMark نحوی برای پانویس ندارد، اما GitHub در سال 2021 پانویس‌های [^1] را اضافه کرد و بیشتر سازنده‌های سایت از آن پشتیبانی میکنند. اگر نمایشگر شما پشتیبانی نکند، متن پانویس بهصورت پاراگراف‌های ساده در انتها می‌آید.
آیا میتوانم Google Docs را هم به این روش به Markdown تبدیل کنم؟
بله. در Google Docs گزینهٔ File > Download > Microsoft Word (.docx) را انتخاب کنید و همان فایل را اینجا بارگذاری کنید. Google Docs گزینهٔ دانلود Markdown هم دارد که برای سندهای ساده خوب کار میکند.
