تولیدکننده TOC برای Markdown ابزارهای Markdown
فارسی
English 日本語 ລາວ Монгол Oʻzbekcha Тоҷикӣ Кыргызча Қазақша Azərbaycan Հայերեն ქართული العربية Български বাংলা čeština Dansk Deutsch Ελληνικά Español Eesti Suomi Français हिन्दी ગુજરાતી ಕನ್ನಡ मराठी മലയാളം Srpski Slovenčina Slovenščina Kiswahili Hrvatski Magyar Indonesia Italiano 한국어 Lietuvių Latviešu Nederlands Norsk Svenska Polski Português Română Русский Українська Беларуская Shqip اردو தமிழ் తెలుగు Türkçe ภาษาไทย Tiếng Việt 简体中文 繁體中文 עברית ខ្មែរ Melayu မြန်မာ ਪੰਜਾਬੀ සිංහල Tagalog नेपाली فارسی

تولیدکننده TOC برای Markdown (خودکار از headingها)

از headingهای Markdown به‌طور خودکار Table of Contents بسازید. سطح headingها را انتخاب کنید (مثل H2-H4)، سپس خروجی قابل ویرایش را کپی کرده و فوراً در سند بچسبانید.

از H2-only، حالت‌های anchor و headingهای تکراری بدون نیاز به تنظیم اضافی پشتیبانی می‌کند.

متن شما به‌صورت محلی در مرورگر می‌ماند و هرگز آپلود نمی‌شود.

نحوه استفاده (30 ثانیه)

  1. متن Markdown خود را بچسبانید.
  2. سطح headingها را انتخاب کنید (فقط H2 / H2-H4 و غیره).
  3. TOC تولیدشده را کپی کنید و در سند خود بچسبانید.

نمونه ورودی و خروجی

نمونه با headingهای تکراری

ورودی

# Document Title
## Overview
## Usage
### Install
### Settings
## FAQ
## FAQ

خروجی (H2-H3 / bullet list / TOC heading روشن)

## Table of contents

- [Overview](#overview)
- [Usage](#usage)
  - [Install](#install)
  - [Settings](#settings)
- [FAQ](#faq)
- [FAQ](#faq-2)

مشخصات (قواعد anchor و headingهای تکراری)

قواعد استخراج heading

  • headingهای ATX (# تا ####) را در بازه انتخاب‌شده استخراج می‌کند.
  • خطوط داخل fenced code blockها (``` ... ```) را نادیده می‌گیرد.
  • از فیلتر سطح استفاده کنید (فقط H2 / H2-H3 / H2-H4 / H1-H4).
  • headingهای Setext (=== / ---) در نسخه اول لحاظ نمی‌شوند.

قواعد ساخت anchor (قاعده ابزار)

  1. متن heading را trim می‌کند.
  2. حروف الفبایی را lowercase می‌کند.
  3. فاصله‌ها را به '-' تبدیل می‌کند.
  4. نمادها به‌جز '-' را حذف می‌کند.
  5. '--' های تکراری را به '-' تبدیل می‌کند.
  6. '-' ابتدایی و انتهایی را trim می‌کند.
  7. وقتی anchor تکراری رخ دهد، -2، -3 و ... را اضافه می‌کند.

رفتار لینک‌های TOC ممکن است بسته به پلتفرم میزبانی و Markdown viewer متفاوت باشد. در صورت نیاز خروجی را ویرایش کنید.

پرسش‌های متداول

آیا می‌توانم TOC فقط برای H2 تولید کنم؟

بله. در Heading levels گزینه «H2 only» را انتخاب کنید.

متن anchor چگونه تعیین می‌شود؟

anchorها از قاعده توضیح‌داده‌شده در این صفحه پیروی می‌کنند. همچنین می‌توانید «Custom» را انتخاب کنید یا خروجی را دستی ویرایش کنید.

با headingهای تکراری چگونه برخورد می‌شود؟

headingهای تکراری suffixهایی مثل -2، -3 می‌گیرند تا anchorها یکتا بمانند.

آیا می‌توانم بعضی headingها را از TOC حذف کنم؟

بله. در تنظیمات پیشرفته از Exclude keywords استفاده کنید.

آیا می‌توانم TOC را بدون لینک تولید کنم؟

بله. حالت anchor را روی «No anchors» بگذارید.

نکات

  • رفتار anchor بسته به محیط Markdown متفاوت است.
  • خروجی قابل ویرایش است تا بتوانید برای renderer خود آن را دقیق‌تر تنظیم کنید.
  • متن ورودی در مرورگر شما به‌صورت محلی پردازش می‌شود.

ابزارهای مرتبط

پیش‌نمایش Markdown فرمت‌کننده جدول Markdown مبدل فهرست شمارشگر نویسه