sphinx builder that outputs markdown files
Project description
PyPI PyPI - Downloads PyPI - Python Version GitHub stars Liberapay receiving Liberapay patrons
sphinx builder that outputs markdown files
Please ★ this repo if you found it useful ★ ★ ★
If you want frontmatter support please use sphinx-jekyll-builder
Features
Generates markdown
Installation
pip3 install sphinx-markdown-builder
Dependencies
Usage
Load extension in configuration.
Sphinx >= 1.8
conf.py
from sphinx_markdown_parser.parser import MarkdownParser
source_suffix = {
'.rst': 'restructuredtext',
'.md': 'markdown'
}
def setup(app):
app.add_source_suffix('.md', 'markdown')
app.add_source_parser(MarkdownParser)
Sphinx < 1.8
conf.py
from sphinx_markdown_parser.parser import MarkdownParser
source_suffix = ['.rst', '.md']
source_parsers = {
'.md': MarkdownParser
}
If using recommonmark, make sure you explicitly ignore the build files as they will conflict with the system.
conf.py
exclude_patterns = [
'build/*'
]
Build markdown files with Makefile
make markdown
Build markdown files with sphinx-build command
cd docs
sphinx-build -M markdown ./ build
Support
Submit an issue
Screenshots
Contribute a screenshot
Contributing
Review the guidelines for contributing
License
Jam Risser © 2018
Changelog
Review the changelog
Credits
Jam Risser - Author
Matthew Brett - doctree2md
Support on Liberapay
A ridiculous amount of coffee ☕ ☕ ☕ was consumed in the process of building this project.
Add some fuel if you’d like to keep me going!
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for sphinx-markdown-builder-0.5.1.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | 0075c4c73cec82f86eec13affdc59e4eda09c4bd8acdd61a2566e245801df7fd |
|
MD5 | 166338fcfc8d81ef79464a05341a057c |
|
BLAKE2b-256 | f81b7f3ea21c3f43445d4f3400b255152c3148f8e9b4000385f6cde8f86b76e9 |
Hashes for sphinx_markdown_builder-0.5.1-py2.py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | a3f50716967f1cdf7d87b67936650ffb4bcb668bacd2b439676eb41d97fd3b5d |
|
MD5 | 413330c50ca3299150d65796c54d3473 |
|
BLAKE2b-256 | 9ddbccd51ea6dfc3bb6e6f6bf5ea754ec45707c7a8ce994d9060f232eed77923 |