How to have plain docs mixed in with React Styleguidist

Question

I'd like to document other functions and parts of my code base with markdown and have them parsed and displayed in a different section of my documentation. How can I do this?

/**
 * Merge route into the global application state
 */ 
export const reducer = (state = initialState, action) => {

Importing them directly into styleguide.config.js results in the entire file being parsed as text.

Answer 1

Generate Markdown documentation using tools like documentation.js, and then include those files as sections into Styleguidist:

module.exports = {
  sections: [
    {
      name: 'Some other API',
      content: 'docs/generated-file.md'
    },
    {
      name: 'Components',
      components: 'lib/components/**/*.js'
    }
  ]
}