Generate Markdown TOC

generate_toc.rb

#!/usr/bin/env ruby

File.open("your_file.md", 'r') do |f|
  f.each_line do |line|
    forbidden_words = ['Table of contents', 'define', 'pragma']
    next if !line.start_with?("#") || forbidden_words.any? { |w| line =~ /#{w}/ }
     
    title = line.gsub("#", "").strip
    href = title.gsub(" ", "-").downcase
    puts "  " * (line.count("#")-1) + "* [#{title}](\##{href})"
  end
end

Awesome - thanks!!

it was also capturing lines commented in code snippets, fix:

#!/usr/bin/env ruby

File.open("finaldocuments/README.md", 'r') do |f|
  inside_code_snippet = false
  f.each_line do |line|
    forbidden_words = ['Table of contents', 'define', 'pragma']
    inside_code_snippet = !inside_code_snippet if line.start_with?('```')
    next if !line.start_with?("#") || forbidden_words.any? { |w| line =~ /#{w}/ } || inside_code_snippet

    title = line.gsub("#", "").strip
    href = title.gsub(" ", "-").downcase
    puts "  " * (line.count("#")-1) + "* [#{title}](\##{href})"
  end
end

Has trouble with # inside codeblocks. Mistakes them for a heading.

# This is a heading
I'm a paragraph, dude!

## This is a heading one level below
I'm a hpargarap spelled backwards!
\```
echo "Some code"
# This must not a be heading
echo "s'more code"
\```

The text # This must not be a heading is mistaken for a heading.

Thanks, very nice. Here is a version that takes the file name as an argument:

#!/usr/bin/env ruby

fileName = ARGV[0]
fileName = "README.md" if !fileName

File.open(fileName, 'r') do |f|
  inside_code_snippet = false
  f.each_line do |line|
    forbidden_words = ['Table of contents', 'define', 'pragma']
    inside_code_snippet = !inside_code_snippet if line.start_with?('```')
    next if !line.start_with?("#") || forbidden_words.any? { |w| line =~ /#{w}/ } || inside_code_snippet

    title = line.gsub("#", "").strip
    href = title.gsub(" ", "-").downcase
    puts "  " * (line.count("#")-1) + "* [#{title}](\##{href})"
  end
end

I updated and included your script in this repo.
https://github.com/shitana/md_TOC_generator
(I also put the link to your script and profile)

The script is not stripping invalid characters used as Headers. For example,

#### The field `b` means ("bug")