এটি করার "যথাযথ" উপায়টি হ'ল মার্কডাউন করার জন্য একটি ডকুমেন্টাল পার্সার লেখা । (পার্সারটি বেছে নেওয়ার জন্য একটি স্পিংস বিকল্পটি প্লাস করুন all) এর সৌন্দর্যটি সমস্ত ডকুমেন্টাল আউটপুট ফর্ম্যাটগুলির তাত্ক্ষণিক সমর্থন হবে (তবে আপনি সম্ভবত এটির যত্ন নেবেন না, কারণ বেশিরভাগ ক্ষেত্রে অনুরূপ মার্কডাউন সরঞ্জাম ইতিমধ্যে বিদ্যমান)। স্ক্র্যাচ থেকে কোনও পার্সার তৈরি না করেই এগুলির কাছে যাওয়ার উপায়:
আপনি প্রতারণা করে এমন একটি "পার্সার" লিখতে পারেন যা পানডোক ব্যবহার করে মার্কডাউনকে আরএসটিতে রূপান্তর করতে এবং সেটি আরএসটি পার্সার :-) এ যেতে পারে।
আপনি একটি বিদ্যমান মার্কডাউন-> এক্সএমএল পার্সার ব্যবহার করতে পারেন এবং ফলাফলটি (এক্সএসএলটি? ব্যবহার করে) ডকুমেন্টিল স্কিমে রূপান্তর করতে পারেন।
আপনি কিছু বিদ্যমান পাইথন মার্কডাউন পার্সার নিতে পারেন যা আপনাকে একটি কাস্টম রেন্ডারারের সংজ্ঞা দিতে এবং এটি ডকুমেন্টিল নোড ট্রি তৈরি করতে দেয়।
আপনি বিদ্যমান আরএসটি পাঠককে কাঁটাচামচ করতে পারেন, মার্কডাউন থেকে অপ্রাসঙ্গিক সবকিছু ছড়িয়ে দিতে এবং বিভিন্ন সিনট্যাক্সগুলি পরিবর্তন করতে পারেন ( এই তুলনাটি সাহায্য করতে পারে) ...
সম্পাদনা: আপনি যদি এটিকে পরীক্ষা করার জন্য প্রস্তুত না হন তবে আমি এই রুটের প্রস্তাব দিই না। মার্কডাউন ইতিমধ্যে অনেকগুলি সাবটলি বিভিন্ন উপভাষা রয়েছে এবং এর ফলস্বরূপ এখনও আরও একটি-এর ফলাফল হবে ...
আপডেট: https://github.com/sgenoud/remarkdown ডকুমেন্টের জন্য একটি মার্কডাউন রিডার। এটি উপরের শর্টকাটগুলির কোনও নেয় নি তবে পেগ -মার্কডাউন দ্বারা অনুপ্রাণিত একটি পার্সলে পিইজি ব্যাকরণ ব্যবহার করে ।
- এখনও নির্দেশাবলী সমর্থন করে না ।
আপডেট: https://github.com/readthedocs/recommonmark এবং অন্য দস্তাবেজ পাঠক, স্থানীয়ভাবে ReadDocs এ সমর্থিত। মন্তব্য থেকে উত্পন্ন কিন্তু কমনমার্ক-পাই পার্সার ব্যবহার করে ।
- এটি নির্দিষ্ট কম-বেশি প্রাকৃতিক মার্কডাউন সিনট্যাক্সগুলিকে উপযুক্ত কাঠামোর মধ্যে রূপান্তর করতে পারে যেমন টোক্রিতে লিঙ্কের তালিকা। * ভূমিকার জন্য জেনেরিক নেটিভ সিনট্যাক্স নেই।
- একটি বেড়া ব্লক সহ নির্দেশাবলী সহ যে কোনও আরএসটি সামগ্রী এম্বেডিং সমর্থন করে
```eval_rst জন্য একটি শর্টহ্যান্ডDIRECTIVE_NAME:: ... ।
আপডেট : মাইএসটি হ'ল আরও একটি ডকুটিন / স্পিনক্স পাঠক। মার্কডাউন-ইট-পাই, কমনমার্কের সাথে সামঞ্জস্যপূর্ণ Based
- জেনেরিক আছে
{ROLE_NAME}`...`ভূমিকার জন্য সিনট্যাক্স রয়েছে।
```{DIRECTIVE_NAME} ...বেড়া ব্লক সহ নির্দেশের জন্য জেনেরিক সিনট্যাক্স রয়েছে ।
ইন সব ক্ষেত্রে, আপনি Markdown এর এক্সটেনশন উদ্ভাবন প্রতিনিধিত্ব করতে হবে স্পিংক্স নির্দেশনা এবং ভূমিকা । আপনার এই সমস্তগুলির প্রয়োজন নাও থাকতে পারে .. toctree::এমন কিছুগুলির জন্য প্রয়োজনীয়।
এটি আমার মনে হয় সবচেয়ে শক্ত অংশ। স্পিনেক্স এক্সটেনশনের পূর্বে পুনর্গঠিত পাঠ্যটি মার্কডাউনয়ের চেয়ে ইতিমধ্যে সমৃদ্ধ ছিল। এমনকি প্রচুর পরিমাণে প্রসারিত মার্কডাউন, যেমন প্যানডোকস এর মার্কডাউনও বেশিরভাগ ক্ষেত্রে আরএসটি বৈশিষ্ট্যসেটের একটি উপসেট। Coverেকে রাখার অনেকটাই জায়গা!
বাস্তবায়ন অনুসারে, সবচেয়ে সহজ জিনিসটি কোনও ডকুমেন্টিলের ভূমিকা / নির্দেশকে প্রকাশ করার জন্য একটি জেনেরিক নির্মাণ যুক্ত করছে। সিনট্যাক্স অনুপ্রেরণার সুস্পষ্ট প্রার্থীরা হলেন:
- অ্যাট্রিবিউট সিনট্যাক্স, যা প্যানডোক এবং অন্যান্য কিছু বাস্তবায়ন ইতিমধ্যে অনেকগুলি ইনলাইন এবং ব্লক নির্মাণগুলিতে অনুমতি দেয়। উদাহরণ স্বরূপ
`foo`{.method} -> `foo`:method:।
- এইচটিএমএল / এক্সএমএল। থেকে
<span class="method">foo</span> মাত্র docutils অভ্যন্তরীণ এক্সএমএল ঢোকাতে kludgiest পদ্ধতির করুন!
- নির্দেশের জন্য কোনও প্রকার YAML?
তবে এ জাতীয় জেনেরিক ম্যাপিং সর্বাধিক মার্কডাউন-ইশ সমাধান হতে পারে না ... বর্তমানে মার্কডাউন এক্সটেনশানগুলি নিয়ে আলোচনার সর্বাধিক সক্রিয় স্থানগুলি হ'ল https://groups.google.com/forum/#!topic/pandoc-discuss , https: // github.com/scholmd/scholmd/
এর অর্থ হ'ল আপনি কোনও মার্কডাউন পার্সারকে কোনওভাবে বাড়িয়ে না দিয়ে পুনরায় ব্যবহার করতে পারবেন না। প্যান্ডোক আবার কাস্টম ফাইলগুলি সমর্থন করে ডকুমেন্ট রূপান্তরকরণের সুইস আর্মি ছুরি হিসাবে খ্যাতি অর্জন করে । (প্রকৃতপক্ষে, আমি যদি এটির কাছে পৌঁছে যাই তবে আমি ডকুমেন্টিল পাঠক / ট্রান্সফর্মার / লেখক এবং প্যানডোক পাঠক / ফিল্টার / লেখকদের মধ্যে জেনেরিক সেতু নির্মাণের চেষ্টা করতাম you এটি আপনার প্রয়োজনের চেয়ে বেশি তবে পেইফটি কেবল স্পিংক্স / এর চেয়ে অনেক বেশি প্রশস্ত হবে) markdown।)
বিকল্প পাগল ধারণা: স্পিনিক্স পরিচালনা করার জন্য মার্কডাউন প্রসারিত করার পরিবর্তে, মার্কডাউন সুপারসেটকে সমর্থন করার জন্য পুনর্গঠনপ্রযুক্তি প্রসারিত করুন (বেশিরভাগ) মার্কডাউনের সুপারসেট! সৌন্দর্যটি হ'ল আপনি যে কোনও স্পিঙ্কস বৈশিষ্ট্যটিকে যেমন রয়েছে তেমন ব্যবহার করতে সক্ষম হবেন, তবুও মার্কডাউনে বেশিরভাগ সামগ্রী লিখতে সক্ষম হবেন।
ইতিমধ্যে যথেষ্ট সিনট্যাক্স ওভারল্যাপ রয়েছে ; উল্লেখযোগ্যভাবে লিঙ্ক সিনট্যাক্সটি বেমানান। আমি মনে করি আপনি যদি মার্কডাউন লিঙ্ক এবং ###স্টাইল শিরোনামগুলির জন্য আরএসটি সমর্থন যোগ করেন এবং ডিফল্ট `backticks`ভূমিকাটিকে আক্ষরিকরূপে পরিবর্তন করেন এবং সম্ভবত ইন্টেন্টেড ব্লকগুলিকে আক্ষরিকরূপে পরিবর্তন করেন (আরএসটি > ...আজকাল উদ্ধৃতিগুলির জন্য সমর্থন করে ), আপনি বেশিরভাগ মার্কডাউনকে সমর্থন করে এমন ব্যবহারযোগ্য কিছু পাবেন ।