Pure markdown files to html generator
up vote
-1
down vote
favorite
We are trying to convert our documentation files (md files) into a static website.
We have been looking at Hugo, Metalsmith and other static site generators.
But we feel that all of them are forcing us to add custom markup or a lot of extra metadata (frontmatter) which we are not really keen on.
F. ex. we have links in the md files that refers to other md files.
Release procedure
For these links to work we have to alter the md code with custom code like relrefs for Hugo and so on. Why can't we just maintain the link code as pure markdown.
We fully understand that the added frontmatter solves a lot of issues and give us a lot of options – but we don’t really need them – we just want to keep it simple.
So is there any site generators that don’t require extra custom code for the linking and structure to work? Or have we misunderstood something within the generators that we have looked at?
markdown hugo static-site metalsmith
asked Nov 7 at 12:37
sonderbazz
1
add a comment |
up vote
-1
down vote
favorite
We are trying to convert our documentation files (md files) into a static website.
We have been looking at Hugo, Metalsmith and other static site generators.
But we feel that all of them are forcing us to add custom markup or a lot of extra metadata (frontmatter) which we are not really keen on.
F. ex. we have links in the md files that refers to other md files.
Release procedure
For these links to work we have to alter the md code with custom code like relrefs for Hugo and so on. Why can't we just maintain the link code as pure markdown.
We fully understand that the added frontmatter solves a lot of issues and give us a lot of options – but we don’t really need them – we just want to keep it simple.
So is there any site generators that don’t require extra custom code for the linking and structure to work? Or have we misunderstood something within the generators that we have looked at?
markdown hugo static-site metalsmith
asked Nov 7 at 12:37
sonderbazz
1
1
Tool recommendations are off-topic here, but you can find a long list of options at staticgen.com and staticsitegenerators.net
– Waylan
Nov 7 at 14:58
Sorry for that - I'm new to stackoverflow. But thx for the links - they give a nice overview of what's out there.
– sonderbazz
Nov 8 at 10:19
add a comment |
up vote
-1
down vote
favorite
up vote
-1
down vote
favorite
We are trying to convert our documentation files (md files) into a static website.
We have been looking at Hugo, Metalsmith and other static site generators.
But we feel that all of them are forcing us to add custom markup or a lot of extra metadata (frontmatter) which we are not really keen on.
F. ex. we have links in the md files that refers to other md files.
Release procedure
For these links to work we have to alter the md code with custom code like relrefs for Hugo and so on. Why can't we just maintain the link code as pure markdown.
We fully understand that the added frontmatter solves a lot of issues and give us a lot of options – but we don’t really need them – we just want to keep it simple.
So is there any site generators that don’t require extra custom code for the linking and structure to work? Or have we misunderstood something within the generators that we have looked at?
markdown hugo static-site metalsmith
asked Nov 7 at 12:37
sonderbazz
1
We are trying to convert our documentation files (md files) into a static website.
We have been looking at Hugo, Metalsmith and other static site generators.
But we feel that all of them are forcing us to add custom markup or a lot of extra metadata (frontmatter) which we are not really keen on.
F. ex. we have links in the md files that refers to other md files.
Release procedure
For these links to work we have to alter the md code with custom code like relrefs for Hugo and so on. Why can't we just maintain the link code as pure markdown.
We fully understand that the added frontmatter solves a lot of issues and give us a lot of options – but we don’t really need them – we just want to keep it simple.
So is there any site generators that don’t require extra custom code for the linking and structure to work? Or have we misunderstood something within the generators that we have looked at?
markdown hugo static-site metalsmith
markdown hugo static-site metalsmith
asked Nov 7 at 12:37
sonderbazz
1
asked Nov 7 at 12:37
sonderbazz
1
asked Nov 7 at 12:37
sonderbazz
1
asked Nov 7 at 12:37
sonderbazz
1
asked Nov 7 at 12:37
sonderbazz
1
1
1
Tool recommendations are off-topic here, but you can find a long list of options at staticgen.com and staticsitegenerators.net
– Waylan
Nov 7 at 14:58
Sorry for that - I'm new to stackoverflow. But thx for the links - they give a nice overview of what's out there.
– sonderbazz
Nov 8 at 10:19
add a comment |
1
Tool recommendations are off-topic here, but you can find a long list of options at staticgen.com and staticsitegenerators.net
– Waylan
Nov 7 at 14:58
Sorry for that - I'm new to stackoverflow. But thx for the links - they give a nice overview of what's out there.
– sonderbazz
Nov 8 at 10:19
1
1
Tool recommendations are off-topic here, but you can find a long list of options at staticgen.com and staticsitegenerators.net
– Waylan
Nov 7 at 14:58
Tool recommendations are off-topic here, but you can find a long list of options at staticgen.com and staticsitegenerators.net
– Waylan
Nov 7 at 14:58
Sorry for that - I'm new to stackoverflow. But thx for the links - they give a nice overview of what's out there.
– sonderbazz
Nov 8 at 10:19
Sorry for that - I'm new to stackoverflow. But thx for the links - they give a nice overview of what's out there.
– sonderbazz
Nov 8 at 10:19
add a comment |
1 Answer
1
active
oldest
votes
up vote
0
down vote
There's a handy Metalsmith plugin to load default values into the "frontmatter" so you could avoid adding much/any special headers into your existing files...
https://github.com/woodyrew/metalsmith-default-values
answered Nov 10 at 21:04
doublejosh
2,83832437
This could solve some of the problems we had - thanks. But still not all that happy about the linking issues.
– sonderbazz
Nov 12 at 8:15
add a comment |
1 Answer
1
active
oldest
votes
1 Answer
1
active
oldest
votes
active
oldest
votes
active
oldest
votes
up vote
0
down vote
There's a handy Metalsmith plugin to load default values into the "frontmatter" so you could avoid adding much/any special headers into your existing files...
https://github.com/woodyrew/metalsmith-default-values
answered Nov 10 at 21:04
doublejosh
2,83832437
This could solve some of the problems we had - thanks. But still not all that happy about the linking issues.
– sonderbazz
Nov 12 at 8:15
add a comment |
up vote
0
down vote
There's a handy Metalsmith plugin to load default values into the "frontmatter" so you could avoid adding much/any special headers into your existing files...
https://github.com/woodyrew/metalsmith-default-values
answered Nov 10 at 21:04
doublejosh
2,83832437
This could solve some of the problems we had - thanks. But still not all that happy about the linking issues.
– sonderbazz
Nov 12 at 8:15
add a comment |
up vote
0
down vote
up vote
0
down vote
There's a handy Metalsmith plugin to load default values into the "frontmatter" so you could avoid adding much/any special headers into your existing files...
https://github.com/woodyrew/metalsmith-default-values
answered Nov 10 at 21:04
doublejosh
2,83832437
There's a handy Metalsmith plugin to load default values into the "frontmatter" so you could avoid adding much/any special headers into your existing files...
https://github.com/woodyrew/metalsmith-default-values
answered Nov 10 at 21:04
doublejosh
2,83832437
answered Nov 10 at 21:04
doublejosh
2,83832437
answered Nov 10 at 21:04
doublejosh
2,83832437
answered Nov 10 at 21:04
doublejosh
2,83832437
2,83832437
This could solve some of the problems we had - thanks. But still not all that happy about the linking issues.
– sonderbazz
Nov 12 at 8:15
add a comment |
This could solve some of the problems we had - thanks. But still not all that happy about the linking issues.
– sonderbazz
Nov 12 at 8:15
This could solve some of the problems we had - thanks. But still not all that happy about the linking issues.
– sonderbazz
Nov 12 at 8:15
This could solve some of the problems we had - thanks. But still not all that happy about the linking issues.
– sonderbazz
Nov 12 at 8:15
add a comment |
Sign up or log in
StackExchange.ready(function () {
StackExchange.helpers.onClickDraftSave('#login-link');
});
Sign up using Google
Sign up using Facebook
Sign up using Email and Password
Post as a guest
Required, but never shown
StackExchange.ready(
function () {
StackExchange.openid.initPostLogin('.new-post-login', 'https%3a%2f%2fstackoverflow.com%2fquestions%2f53189627%2fpure-markdown-files-to-html-generator%23new-answer', 'question_page');
}
);
Post as a guest
Required, but never shown
Sign up or log in
StackExchange.ready(function () {
StackExchange.helpers.onClickDraftSave('#login-link');
});
Sign up using Google
Sign up using Facebook
Sign up using Email and Password
Post as a guest
Required, but never shown
Sign up or log in
StackExchange.ready(function () {
StackExchange.helpers.onClickDraftSave('#login-link');
});
Sign up using Google
Sign up using Facebook
Sign up using Email and Password
Post as a guest
Required, but never shown
Sign up or log in
StackExchange.ready(function () {
StackExchange.helpers.onClickDraftSave('#login-link');
});
Sign up using Google
Sign up using Facebook
Sign up using Email and Password
Sign up using Google
Sign up using Facebook
Sign up using Email and Password
Post as a guest
Required, but never shown
Required, but never shown
Required, but never shown
Required, but never shown
Required, but never shown
Required, but never shown
Required, but never shown
Required, but never shown
Required, but never shown
1
Tool recommendations are off-topic here, but you can find a long list of options at staticgen.com and staticsitegenerators.net
– Waylan
Nov 7 at 14:58
Sorry for that - I'm new to stackoverflow. But thx for the links - they give a nice overview of what's out there.
– sonderbazz
Nov 8 at 10:19