Support output as Markdown instead of html, for example, for github readme.md
See original GitHub issueDocFX does a great job in building static websites. But, I want to know if there is a way to export the files in Markdown. It would then be easy to put up on GitHub wikis or GitBook.
And by that I mean that I don’t require features like search, Affix, Breadcrumb, navbar, footer, etc.
Here’s what I tried:
- Renamed
*.html.primary.*
files to*.md.primary.*
- Modified partials and templates from html to markdown.
- Removed unnecessary features.
That was a good progress but with two major problems:
- Markdown in conceptual documentation was getting converted to html. I really need to prevent this. Trying to add the *.md files to resources failed resulting in unresolved links.
- Xml Documentation was being converted to html.
So, finally it seems that I want some way to convert that output html to markdown.
Any help is appreciated and BTW thank you for this awesome software.
Issue Analytics
- State:
- Created 7 years ago
- Reactions:64
- Comments:24 (12 by maintainers)
Top Results From Across the Web
How to display HTML content in github README.md?
3 Answers. Github's markdown interpreter can include HTML. However, there is only so much you can do in HTML. I would suggest checking...
Read more >Markdown output - CKEditor 5 Documentation
CKEditor 5 can be configured to output Markdown instead of HTML. Markdown is a lightweight markup language that you can use to add...
Read more >Guide to writing on Readme.md (.markdown)file for GitHub ...
Markdown can be converted into other formats (such as HTML) and has been incorporated into many things. It's the standard format for ReadMe...
Read more >Markdown | IntelliJ IDEA Documentation
IntelliJ IDEA recognizes Markdown files, provides a dedicated editor with highlighting, completion, and formatting, and shows the rendered HTML ...
Read more >Markdown editing with Visual Studio Code
Working with Markdown files in Visual Studio Code is simple, straightforward, and fun. Besides VS Code's basic editing, there are a number of...
Read more >
Top Related Medium Post
No results found
Top Related StackOverflow Question
Troubleshoot Live Code
Lightrun enables developers to add logs, metrics and snapshots to live code - no restarts or redeploys required.
Start Free
Top Related Reddit Thread
No results found
Top Related Hackernoon Post
No results found
Top Related Tweet
No results found
Top Related Dev.to Post
No results found
Top Related Hashnode Post
No results found
@chenkennt I want DocFX to extract xml documentation from source code and augment my markdown files into it.
This would be really useful as a means of posting generated documentation in Azure DevOps (as a “Code Wiki”). For that reason I would support the standards recommended by them here which includes the standard DaringFireball standard and the GitHub Extensions.