{"id":18434700,"url":"https://github.com/assemble/assemble-boilerplate-markdown","last_synced_at":"2025-12-12T04:00:54.651Z","repository":{"id":47791358,"uuid":"10885210","full_name":"assemble/assemble-boilerplate-markdown","owner":"assemble","description":"Use Assemble to generate HTML pages from markdown content. Useful for wikis, gh-pages, documentation and blogs or sites with markdown posts.","archived":false,"fork":false,"pushed_at":"2014-05-05T14:08:30.000Z","size":695,"stargazers_count":17,"open_issues_count":2,"forks_count":28,"subscribers_count":11,"default_branch":"master","last_synced_at":"2025-03-23T00:02:29.215Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"http://assemble.github.io/boilerplate-markdown","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/assemble.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE-MIT","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2013-06-23T13:47:16.000Z","updated_at":"2022-11-28T16:15:27.000Z","dependencies_parsed_at":"2022-08-31T03:41:46.310Z","dependency_job_id":null,"html_url":"https://github.com/assemble/assemble-boilerplate-markdown","commit_stats":null,"previous_names":["assemble/assemble-examples-markdown"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/assemble%2Fassemble-boilerplate-markdown","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/assemble%2Fassemble-boilerplate-markdown/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/assemble%2Fassemble-boilerplate-markdown/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/assemble%2Fassemble-boilerplate-markdown/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/assemble","download_url":"https://codeload.github.com/assemble/assemble-boilerplate-markdown/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247716351,"owners_count":20984225,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-11-06T06:04:59.092Z","updated_at":"2025-12-12T04:00:54.129Z","avatar_url":"https://github.com/assemble.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# assemble-examples-markdown [![NPM version](https://badge.fury.io/js/assemble-examples-markdown.png)](http://badge.fury.io/js/assemble-examples-markdown)\n\n\u003e Use Assemble to generate HTML pages from markdown content. Useful for wikis, gh-pages, documentation and blogs or sites with markdown posts.\n\n#### Thank you to [Upstage](https://github.com/upstage) for the theme used in the [live demo](http://assemble.github.io/boilerplate-markdown) (the same used on http://assemble.io)!\n\nThis is not intended to be \"documentation\" for Assemble, the content used in this project is for example purposes. So you will learn by browsing the source code, rendered code, and seeing how it renders in the browser.\n\n## Related information\n\n* [grunt-init-assemble](https://github.com/assemble/grunt-init-assemble): use [grunt-init](http://gruntjs.com/project-scaffolding) to launch new Assemble projects in seconds.\n* [Assemble's documentation](http://assemble.io): if you want to learn more about Assemble in general, this is a great place to start.\n* [assemble-boilerplate](https://github.com/assemble/assemble-boilerplate): see more examples.\n\n\n## What you'll see in the examples\n\n* How to use [file globbing](https://github.com/isaacs/node-glob) to include multiple markdown files based on specified patterns.\n\n### Rendering markdown to markdown\n\n* How to generate markdown files from markdown pages. See [../src/content/TOC.md](../src/content/TOC.md)\n* How to use markdown \"includes\" that either render to HTML or render as markdown\n* How to use markdown layouts for generating markdown files\n\n### Rendering markdown to HTML\n\n* How to write markdown \"inline\" with HTML and have it render to HTML\n* How to generate HTML files from markdown pages, layouts and content.\n\n\n## Getting started\n\nIf you have trouble getting started, please visit the documentation at http://assemble.io, or [create an Issue](https://github.com/assemble/assemble/issues) at Assemble's GitHub repo, we're happy to help.\n\nThis plugin requires Grunt `~0.4.1`. If you haven't used [Grunt](http://gruntjs.com/) before, be sure to check out the [Getting Started](http://gruntjs.com/getting-started) guide, as it explains how to create a [Gruntfile](http://gruntjs.com/sample-gruntfile) as well as install and use Grunt plugins. Once you're familiar with that process, you may install this plugin with this command:\n\n```shell\nnpm install assemble --save-dev\n```\n\nOnce the plugin has been installed, it may be enabled inside your [Gruntfile][Getting Started] with this line of JavaScript:\n\n```js\ngrunt.loadNpmTasks('assemble');\n```\n\n## The \"assemble\" task\nIn your project's Gruntfile, add a section named `assemble` to the data object passed into `grunt.initConfig()`.\n\n```js\ngrunt.initConfig({\n  assemble: {\n    options: {\n      // Task-specific options go here.\n    },\n    your_target: {\n      // Target-specific file lists and/or options go here.\n    }\n  }\n});\ngrunt.loadNpmTasks('assemble');\n\ngrunt.registerTask('default', [\n  'jshint',\n  'assemble'\n]);\n```\nTask targets, files and options may be specified according to the grunt [Configuring tasks](http://gruntjs.com/configuring-tasks) guide.\n\n\nYou should now be able to run `grunt assemble` to build the project.\n\nVisit [Assemble's documentation](http://assemble.io) for more information.\n\n\n## Contributing\nIn lieu of a formal styleguide, take care to maintain the existing coding style. Add unit tests for any new or changed functionality. Lint and test your code using [grunt][].\n\n## Release History\n_(Nothing yet)_\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fassemble%2Fassemble-boilerplate-markdown","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fassemble%2Fassemble-boilerplate-markdown","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fassemble%2Fassemble-boilerplate-markdown/lists"}