Thanks for the good ideas but all those solutions only seem to show the TOC in the markdown preview. I probably wasn’t clear enough that the main goal is to generate the TOC in the .md file and have it display in the .md file while still editing in BBEdit.
I’d prefer to not have to manually add any special attributes such as <a name=“my section name"></a> to each header as some tools require but that wouldn’t be a show stopper. For example, after putting the insertion point at the start of my document (or not doing that if the script is smart enough to do it for me), then running the script/plugin/etc. I’d expect to see the TOC inserted at the start of the document or just below the “title” (H1 header). Something similar to the following... Before Document Title ============== --- ## Section One Blah --- ## Section Two Blah blah After without clickable links Document Title ============== --- ## Table of Contents 1. Section One 2. Section Two --- ## Section One Blah --- ## Section Two Blah blah After with clickable links Document Title ============== --- ## Table of Contents 1. [Section One](#section-one) 2. [Section Two](#section-two) — <a name="section-one"></a> ## Section One Blah --- <a name=“section-two"></a> ## Section Two Blah blah Thanks, Craig > On Aug 11, 2022, at 1:13 AM, Craig Maynard <[email protected]> wrote: > > The Jekyll gem uses a markdown processor called kramdown. When I want a table > of contents, I add this two-line directive to my markdown file: > > * TOC > {:toc} > > I suppose you could take a look at the source code for kramdown to see how it > works. > > > On Wednesday, August 10, 2022 at 5:26:05 PM UTC-4 craigh wrote: > I see that there are various methods of generating a markdown table of > contents (TOC) in markdown-specific editors or via plugins/scripts. > > For example, if I include <!—TOC—> in my doc.md file, then open it in Marked > 2, Marked 2 will generate and display a table of contents at the top of the > document. Looking at the html generated by Marked 2 shows that it’s doing > something fancy in that it’s adding ids to each heading (e.g., <h2 > id="documents">Documents</h2>) and then has some magic (to me) at the top > (<div class="mkrelocated-toc"></div>) to show the TOC. > > What I’m really looking for is something (probably a script?) that I can run > while editing the .md file in bbedit to generate the TOC directly in the .md > file. I’m guessing that having the TOC update itself automatically is asking > way too much but I’d be happy just being able to delete an old TOC and > regenerate a new one manually. > > Any suggestions? > > Thanks, > > Craig > > > -- > Craig Heilman > Bugaboo Software > > > > > -- > This is the BBEdit Talk public discussion group. If you have a feature > request or need technical support, please email "[email protected]" > rather than posting here. Follow @bbedit on Twitter: > <https://twitter.com/bbedit <https://twitter.com/bbedit>> > --- > You received this message because you are subscribed to the Google Groups > "BBEdit Talk" group. > To unsubscribe from this group and stop receiving emails from it, send an > email to [email protected] > <mailto:[email protected]>. > To view this discussion on the web visit > https://groups.google.com/d/msgid/bbedit/d349434f-6544-4090-a3ee-5e151c7dcaafn%40googlegroups.com > > <https://groups.google.com/d/msgid/bbedit/d349434f-6544-4090-a3ee-5e151c7dcaafn%40googlegroups.com?utm_medium=email&utm_source=footer>. -- Craig Heilman Bugaboo Software -- This is the BBEdit Talk public discussion group. If you have a feature request or need technical support, please email "[email protected]" rather than posting here. Follow @bbedit on Twitter: <https://twitter.com/bbedit> --- You received this message because you are subscribed to the Google Groups "BBEdit Talk" group. To unsubscribe from this group and stop receiving emails from it, send an email to [email protected]. To view this discussion on the web visit https://groups.google.com/d/msgid/bbedit/22A2660C-0731-4F7E-B62C-F0CE88D988B3%40bugsoft.com.
