Markflow

Simple on-the-go markdown reader and editor for iOS.

Version 0.1.0 · iOS 26 · SwiftUI

---

---

Markflow is a native markdown reader and editor for iOS 26. Tap any .md file in Files, Mail, or Safari and it opens rendered: code blocks, mermaid diagrams, tables, inline images. Files open read-only by default and edits live in memory until you explicitly choose Save, Save as New File, or Share.

How it works

Files open in read-only mode by default. Switch to Edit and changes live in memory until you explicitly Save, Save as New File, or Share. The rich-text toolbar above the keyboard covers bold, italic, headings, lists, links, images, code, and blockquotes. Pinch-to-zoom works in both modes: WKWebView zoom in Preview, font scaling in Edit.

Build from source

Requires Xcode 26 and the iOS 26 simulator runtime.

cd Markflow
xcodegen generate
xcodebuild -project Markflow.xcodeproj -scheme Markflow \
  -destination 'platform=iOS Simulator,name=iPhone 16e' build

Or open in Xcode and press ⌘R:

open Markflow.xcodeproj

For a physical-device build, the bundle is signed under Team QAMM2A6WRQ (Apple Developer Program). Select your iPhone in Xcode's device picker and hit Run.

Project layout

File tree

md-reader/
├── Markflow.xcodeproj/         # generated by xcodegen
├── project.yml                 # xcodegen config
├── Markflow/
│   ├── MarkflowApp.swift       # @main, WindowGroup { HomeView() }
│   ├── Info.plist              # CFBundleDocumentTypes for .md handler
│   ├── Assets.xcassets/        # AppIcon (1024) + HomeIcon (for in-app display)
│   ├── Resources/
│   │   ├── welcome.md          # Template shown on Create
│   │   ├── preview.html        # HTML template + CSS
│   │   ├── marked.min.js       # markdown -> HTML (40 KB)
│   │   ├── highlight.min.js    # syntax highlighting (125 KB)
│   │   ├── highlight-github.css
│   │   ├── highlight-github-dark.css
│   │   └── mermaid.min.js      # flowcharts (3 MB)
│   └── Views/
│       ├── HomeView.swift      # gradient home with Browse/Create CTAs
│       ├── DocumentView.swift  # nav bar with picker + share
│       ├── EditView.swift      # UITextView + markdown toolbar + pinch font scaling
│       └── PreviewView.swift   # WKWebView wrapper

Known limitations

• Relative image paths in markdown (![](image.png)) don't resolve. Use absolute URLs.
• No "Recents" list on the home screen (dropped when we replaced DocumentGroup).

Support

User support: see docs/support.md or email hi@santiagoalonso.com.

Bug reports and feature requests: open an issue.

Acknowledgements

Rendering libraries, vendored in Markflow/Resources/:

• marked for markdown parsing
• highlight.js for syntax highlighting
• Mermaid for diagrams and flowcharts

License

MIT

---

Made by santiagoalonso.com