Mark facilitates synchronization between markdown documentation and Atlassian Confluence pages. It reads markdown files containing metadata to create or update Confluence pages, managing attachments and translating markdown into HTML. Mark solves the problem of manually updating Confluence pages from markdown sources, integrating documentation directly into the workflow.
Mark's use of metadata headers allows for flexible page creation and updating without requiring Confluence admin intervention. It supports attachments, templates, and macros, enabling complex content structures. The file format is extended markdown, preserving readability while adding metadata capabilities. Automated title extraction enhances ease of use.
- Confluence Integration: Seamlessly syncs markdown with Confluence pages.
- Metadata-Driven: Uses metadata headers for page creation and updates.
- Attachment Support: Handles image and file attachments from markdown.
- Templating: Supports Go templates for dynamic content generation.
- Macro Definitions: Enables reusable content blocks with custom logic.
- Layout Customization: Allows layout modifications via HTML comments.
- Code Blocks: Supports collapsible code blocks with various options.
Mark is an active project with ongoing development, indicated by recent commits and a responsive community. Documentation is comprehensive, covering various features and usage scenarios. Regular updates suggest reliable maintenance and support, ensuring continued compatibility with Confluence and markdown standards.
Developers and technical writers benefit from Mark by automating the process of synchronizing markdown documentation with Confluence. Its primary use cases include managing software documentation, creating technical specifications, and maintaining knowledge bases. Mark streamlines content management, reduces manual effort, and ensures consistency between markdown source and Confluence pages.