The easiest way to generate static html page from markdown
\n \n\n```\n\nHere we use [markdown-it](https://github.com/markdown-it/markdown-it) with plugins [markdown-it-anchor](https://github.com/valeriangalliat/markdown-it-anchor) and [markdown-it-title](https://github.com/valeriangalliat/markdown-it-title) to parse the markdown file.\n\n### Copy static files\n\nIf there are other static files which are not ended with `.md` or start with `_`, we will simply copy them:\n\n```\ndocs/\n├── public/\n| ├── css\n| | └── site.css\n| └── index.html\n└── src/\n ├── css\n | └── site.css\n ├── _layout.js\n └── index.md\n```\n\n### Sub page and sub layout\n\nWe can have sub directory which contains markdown files.\n\nSub directory can also have a `_layout.js` file.\n\nFor each markdown file, it will walk your file system looking for the nearest `_layout.js` as the template. It starts from the current directory of the markdown file and then moves to the parent directory until it finds the `_layout.js`\n\n```\ndocs/\n├── public/\n| ├── css\n| | └── site.css\n| └── index.html\n| └── sub\n| └── index.html\n└── src/\n ├── css\n | └── site.css\n ├── _layout.js\n |── index.md\n └── sub\n ├── _layout.js\n └── index.md\n```\n\n### Front matter\n\nFront matter allows us add extra meta data to markdown:\n\n```markdown\n---\nauthor: xcatliu\npublished: 2017-03-02\n---\n\n# Pagic\n\nThe easiest way to generate static html page from markdown\n```\n\nThen in `_layout.js`, we can get a `frontMatter` object which contains the meta data:\n\n```js\nmodule.exports = function ({ title, content, frontMatter }) {\n return `\n \n \n \n| Variable | \nInterpretation | \n
|---|---|
title | \n The title of current page, usually is the first # Title in the markdown | \n
content | \n The content of current page | \n
frontMatter | \n The frontMatter object of current markdown | \n
relativeToRoot | \n The relative path from current markdown file to root directory | \n
config | \n The json format of _config.yml. You can add your custom data to it | \n
filePath | \n The current markdown file path | \n