Create a simple HTML website from multiple Markdown files with Python using Pandoc
 
 
 
Go to file
Helmut Kaczmarek 4e074abd36 Minor typographic changes 2023-08-26 13:21:40 +02:00
Assets Initial commit 2023-08-23 08:50:31 +02:00
HTML Initial commit 2023-08-23 08:50:31 +02:00
Markdown Initial commit 2023-08-23 08:50:31 +02:00
Pandoc Initial commit 2023-08-23 08:50:31 +02:00
LICENSE Initial commit 2023-08-23 08:50:31 +02:00
README.md Minor typographic changes 2023-08-23 09:00:51 +02:00
pydoc.py Minor typographic changes 2023-08-26 13:21:40 +02:00
settings.conf Initial commit 2023-08-23 08:50:31 +02:00

README.md

pydoc – Create a simple HTML website from multiple Markdown files with Python using Pandoc

This little command line tool written in Python loops through a directory on your hard drive and converts all existing Markdown files into HTML files.

Features

  • Converts all Markdown files of all subdirectories into HTML files and keeps the folder structure.
  • If a Markdown file is deleted, the program recognizes this and removes the corresponding HTML file.
  • The program takes into account a template file template.txt for Pandoc.
  • Additionally required files such as style.css or robots.txt can be stored in the assets folder, which are also copied to the HTML folder. If files are removed from the assets folder, the program recognizes this and deletes them from the HTML folder.
  • The program uses a configuration file settings.conf in which the important paths are stored.

CSS in subdirectories

If you use a style sheet, css_path in settings.conf should contain the absolute Path to your .css file (C:\Path\To\Assets\style.css or https://www.your-website.com/style.css), otherwise CSS won't work in subdirectories.